@lanonasis/memory-client 1.0.1 → 2.1.0

package/dist/index.esm.js

@@ -1,20 +1,259 @@
-import { exec, execSync } from 'child_process';
-import { promisify } from 'util';
 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()
+});
+// ========================================
+// 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')
+});
 
 /**
- * Memory Client class for interacting with the Memory as a Service API
+ * 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
  */
-class MemoryClient {
+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
+ *
+ * NO Node.js dependencies, NO CLI code, NO child_process
+ * Works in: Browser, React Native, Cloudflare Workers, Edge Functions, Deno, Bun
+ *
+ * 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
+ *
+ * This is a pure browser-safe client with zero Node.js dependencies.
+ * It uses only standard web APIs (fetch, AbortController, etc.)
+ */
+class CoreMemoryClient {
     constructor(config) {
         this.config = {
             timeout: 30000,
-            useGateway: true,
             ...config
         };
         this.baseHeaders = {
             'Content-Type': 'application/json',
-            'User-Agent': '@lanonasis/memory-client/1.0.0',
+            'User-Agent': '@lanonasis/memory-client/2.0.0',
+            'X-Project-Scope': 'lanonasis-maas', // Required by backend auth middleware
             ...config.headers
         };
         // Set authentication headers
@@ -24,48 +263,171 @@ class MemoryClient {
         else if (config.apiKey) {
             this.baseHeaders['X-API-Key'] = config.apiKey;
         }
+        // Add organization ID header if provided
+        if (config.organizationId) {
+            this.baseHeaders['X-Organization-ID'] = config.organizationId;
+        }
     }
     /**
-     * Make an HTTP request to the API
+     * Enrich request body with organization context if configured
+     * This ensures the API has the organization_id even if not in auth token
+     */
+    enrichWithOrgContext(body) {
+        // If organizationId is configured, include it in the request body
+        if (this.config.organizationId && !body.organization_id) {
+            return {
+                ...body,
+                organization_id: this.config.organizationId
+            };
+        }
+        // Fallback to userId if no organizationId configured
+        if (!this.config.organizationId && this.config.userId && !body.organization_id) {
+            return {
+                ...body,
+                organization_id: this.config.userId
+            };
+        }
+        return body;
+    }
+    /**
+     * 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 {
+                this.config.onRequest(endpoint);
+            }
+            catch (error) {
+                console.warn('onRequest hook error:', error);
+            }
+        }
         // Handle gateway vs direct API URL formatting
         const baseUrl = this.config.apiUrl.includes('/api')
             ? 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();
+        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 {
+                        const duration = Date.now() - startTime;
+                        this.config.onResponse(endpoint, duration);
+                    }
+                    catch (error) {
+                        console.warn('onResponse hook error:', error);
+                    }
+                }
+                return { data, meta: { duration: Date.now() - startTime, retries: attempt } };
             }
-            if (!response.ok) {
-                return {
-                    error: data?.error || `HTTP ${response.status}: ${response.statusText}`
-                };
+            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 } };
+                }
+                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;
+                }
+                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 } };
             }
-            return { data };
         }
-        catch (error) {
-            if (error instanceof Error && error.name === 'AbortError') {
-                return { error: 'Request timeout' };
-            }
+        // 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
@@ -75,12 +437,18 @@ class MemoryClient {
     }
     // 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',
-            body: JSON.stringify(memory)
+            body: JSON.stringify(enrichedMemory)
         });
     }
     /**
@@ -90,9 +458,14 @@ class MemoryClient {
         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)
@@ -126,31 +499,45 @@ class MemoryClient {
         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',
-            body: JSON.stringify(request)
+            body: JSON.stringify(enrichedRequest)
         });
     }
     /**
      * Bulk delete multiple memories
      */
     async bulkDeleteMemories(memoryIds) {
+        const enrichedRequest = this.enrichWithOrgContext({ memory_ids: memoryIds });
         return this.request('/memory/bulk/delete', {
             method: 'POST',
-            body: JSON.stringify({ memory_ids: memoryIds })
+            body: JSON.stringify(enrichedRequest)
         });
     }
     // 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',
-            body: JSON.stringify(topic)
+            body: JSON.stringify(enrichedTopic)
         });
     }
     /**
@@ -188,6 +575,182 @@ class MemoryClient {
     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
@@ -229,17 +792,431 @@ class MemoryClient {
     }
 }
 /**
- * Factory function to create a new Memory Client instance
+ * Factory function to create a new Core Memory Client instance
  */
 function createMemoryClient(config) {
-    return new MemoryClient(config);
+    return new CoreMemoryClient(config);
 }
 
+/**
+ * Error handling for Memory Client
+ * Browser-safe, no Node.js dependencies
+ */
+/**
+ * Standardized error codes for programmatic error handling
+ */
+const ERROR_CODES = [
+    'API_ERROR',
+    'AUTH_ERROR',
+    'VALIDATION_ERROR',
+    'TIMEOUT_ERROR',
+    'RATE_LIMIT_ERROR',
+    'NOT_FOUND',
+    'NETWORK_ERROR',
+    'FORBIDDEN',
+    'CONFLICT',
+    'SERVER_ERROR'
+];
+/**
+ * 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 = 'API_ERROR', statusCode, details) {
+        super(message);
+        this.code = code;
+        this.statusCode = statusCode;
+        this.details = details;
+        this.name = 'MemoryClientError';
+        // Maintains proper stack trace for where our error was thrown (only available on V8)
+        if (Error.captureStackTrace) {
+            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
+ */
+class ApiError extends MemoryClientError {
+    constructor(message, statusCode, details) {
+        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 {
+    constructor(message = 'Authentication required') {
+        super(message, 'AUTH_ERROR', 401);
+        this.name = 'AuthenticationError';
+    }
+}
+/**
+ * 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);
+    }
+}
+/**
+ * Timeout error
+ */
+class TimeoutError extends MemoryClientError {
+    constructor(message = 'Request timeout') {
+        super(message, 'TIMEOUT_ERROR', 408);
+        this.name = 'TimeoutError';
+    }
+}
+/**
+ * Rate limit error with retry-after info
+ */
+class RateLimitError extends MemoryClientError {
+    constructor(message = 'Rate limit exceeded', retryAfter) {
+        super(message, 'RATE_LIMIT_ERROR', 429, { retryAfter });
+        this.name = 'RateLimitError';
+        this.retryAfter = retryAfter;
+    }
+}
+/**
+ * Not found error
+ */
+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);
+    }
+}
+
+/**
+ * @lanonasis/memory-client
+ *
+ * Universal Memory as a Service (MaaS) Client SDK for Lanonasis
+ * Intelligent memory management with semantic search capabilities
+ *
+ * v2.0.0 - Universal SDK Redesign
+ * "Drop In and Sleep" Architecture - Works everywhere with zero configuration
+ *
+ * @example Browser/Web App
+ * ```ts
+ * import { createMemoryClient } from '@lanonasis/memory-client/core';
+ * const client = createMemoryClient({ apiKey: 'your-key' });
+ * ```
+ *
+ * @example Node.js
+ * ```ts
+ * import { createNodeMemoryClient } from '@lanonasis/memory-client/node';
+ * const client = await createNodeMemoryClient({ apiKey: process.env.KEY });
+ * ```
+ *
+ * @example React
+ * ```tsx
+ * import { MemoryProvider, useMemories } from '@lanonasis/memory-client/react';
+ * ```
+ *
+ * @example Vue
+ * ```ts
+ * import { createMemoryPlugin, useMemories } from '@lanonasis/memory-client/vue';
+ * ```
+ */
+// ========================================
+// Internal Imports (for use in this file)
+// ========================================
+// ========================================
+// Constants
+// ========================================
+const VERSION = '2.0.0';
+const CLIENT_NAME = '@lanonasis/memory-client';
+// ========================================
+// Environment Detection
+// ========================================
+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
+// ========================================
+const defaultConfigs = {
+    development: {
+        apiUrl: 'http://localhost:3001',
+        timeout: 30000,
+    },
+    production: {
+        apiUrl: 'https://api.lanonasis.com',
+        timeout: 15000,
+    },
+    edge: {
+        apiUrl: 'https://api.lanonasis.com',
+        timeout: 5000,
+    }
+};
+// Note: Enhanced client requires Node.js, so we don't export it from main entry
+// Users should import from '@lanonasis/memory-client/node' instead
+// ========================================
+// Usage Instructions
+// ========================================
+/**
+ * # @lanonasis/memory-client v2.0
+ *
+ * ## Quick Start
+ *
+ * ### Browser / Web App
+ * ```bash
+ * npm install @lanonasis/memory-client
+ * ```
+ * ```typescript
+ * import { createMemoryClient } from '@lanonasis/memory-client/core';
+ *
+ * const client = createMemoryClient({
+ *   apiUrl: 'https://api.lanonasis.com',
+ *   apiKey: 'your-key-here'
+ * });
+ *
+ * const memories = await client.listMemories();
+ * ```
+ *
+ * ### Node.js with CLI Support
+ * ```typescript
+ * import { createNodeMemoryClient } from '@lanonasis/memory-client/node';
+ *
+ * const client = await createNodeMemoryClient({
+ *   apiKey: process.env.LANONASIS_KEY,
+ *   preferCLI: true // Automatically uses CLI if available
+ * });
+ *
+ * const result = await client.listMemories();
+ * console.log(`Using: ${result.source}`); // 'cli' or 'api'
+ * ```
+ *
+ * ### React
+ * ```tsx
+ * import { MemoryProvider, useMemories } from '@lanonasis/memory-client/react';
+ *
+ * function App() {
+ *   return (
+ *     <MemoryProvider apiKey="your-key">
+ *       <MemoryList />
+ *     </MemoryProvider>
+ *   );
+ * }
+ *
+ * function MemoryList() {
+ *   const { memories, loading } = useMemories();
+ *   if (loading) return <div>Loading...</div>;
+ *   return <div>{memories.map(m => <div key={m.id}>{m.title}</div>)}</div>;
+ * }
+ * ```
+ *
+ * ### Vue 3
+ * ```typescript
+ * import { createMemoryPlugin, useMemories } from '@lanonasis/memory-client/vue';
+ *
+ * const app = createApp(App);
+ * app.use(createMemoryPlugin({ apiKey: 'your-key' }));
+ * ```
+ *
+ * ### Edge Functions (Cloudflare Workers, Vercel Edge)
+ * ```typescript
+ * import { createMemoryClient } from '@lanonasis/memory-client/core';
+ * import { edgePreset } from '@lanonasis/memory-client/presets';
+ *
+ * export default {
+ *   async fetch(request: Request, env: Env) {
+ *     const client = createMemoryClient(edgePreset({
+ *       apiKey: env.LANONASIS_KEY
+ *     }));
+ *     const memories = await client.searchMemories({ query: 'test' });
+ *     return Response.json(memories.data);
+ *   }
+ * };
+ * ```
+ *
+ * ## Bundle Sizes
+ *
+ * - **Core** (browser): ~15KB gzipped
+ * - **Node** (with CLI): ~35KB gzipped
+ * - **React**: ~18KB gzipped (+ React)
+ * - **Vue**: ~17KB gzipped (+ Vue)
+ * - **Presets**: ~2KB gzipped
+ *
+ * ## Documentation
+ *
+ * - Full docs: https://docs.lanonasis.com/sdk
+ * - API reference: https://docs.lanonasis.com/api
+ * - Examples: https://github.com/lanonasis/examples
+ */
+
 /**
  * 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);
 /**
@@ -313,8 +1290,10 @@ class CLIIntegration {
                 const { stdout: authOutput } = await execAsync('onasis auth status --output json 2>/dev/null || lanonasis auth status --output json 2>/dev/null', {
                     timeout: 3000
                 });
-                const authStatus = JSON.parse(authOutput);
-                authenticated = authStatus.authenticated === true;
+                const parseResult = safeJsonParse(authOutput);
+                if (parseResult.success) {
+                    authenticated = parseResult.data.authenticated === true;
+                }
             }
             catch {
                 // Authentication check failed
@@ -336,10 +1315,10 @@ class CLIIntegration {
     async executeCLICommand(command, options = {}) {
         const cliInfo = await this.detectCLI();
         if (!cliInfo.available) {
-            return { error: 'CLI not available' };
+            return { error: createErrorResponse('CLI not available', 'API_ERROR') };
         }
         if (!cliInfo.authenticated) {
-            return { error: 'CLI not authenticated. Run: onasis login' };
+            return { error: createErrorResponse('CLI not authenticated. Run: onasis login', 'AUTH_ERROR', 401) };
         }
         try {
             const timeout = options.timeout || 30000;
@@ -356,22 +1335,20 @@ class CLIIntegration {
                 console.warn('CLI warning:', stderr);
             }
             if (outputFormat === 'json') {
-                try {
-                    const result = JSON.parse(stdout);
-                    return { data: result };
-                }
-                catch (parseError) {
-                    return { error: `Failed to parse CLI JSON output: ${parseError instanceof Error ? parseError.message : 'Unknown error'}` };
+                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: 'CLI command timeout' };
+                return { error: createErrorResponse('CLI command timeout', 'TIMEOUT_ERROR', 408) };
             }
             return {
-                error: error instanceof Error ? error.message : 'CLI command failed'
+                error: createErrorResponse(error instanceof Error ? error.message : 'CLI command failed', 'API_ERROR')
             };
         }
     }
@@ -439,14 +1416,14 @@ class CLIIntegration {
     async getMCPStatus() {
         const cliInfo = await this.detectCLI();
         if (!cliInfo.mcpAvailable) {
-            return { error: 'MCP not available via CLI' };
+            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: 'MCP not available via CLI' };
+            return { error: createErrorResponse('MCP not available via CLI', 'API_ERROR') };
         }
         return this.executeCLICommand('mcp tools');
     }
@@ -499,6 +1476,8 @@ class CLIIntegration {
  *
  * 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
@@ -514,21 +1493,24 @@ class EnhancedMemoryClient {
     }
     constructor(config) {
         this.capabilities = null;
-        this.config = {
-            preferCLI: true,
-            enableMCP: true,
-            cliDetectionTimeout: 5000,
-            fallbackToAPI: true,
-            minCLIVersion: '1.5.2',
-            verbose: false,
-            timeout: 30000,
-            useGateway: true,
+        // 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 || {},
-            ...config
+            headers: config.headers || {}
         };
-        this.directClient = new MemoryClient(config);
+        this.config = mergedConfig;
+        this.directClient = new CoreMemoryClient(config);
         this.cliIntegration = new CLIIntegration();
     }
     /**
@@ -623,7 +1605,7 @@ class EnhancedMemoryClient {
                     };
                 }
                 return {
-                    error: error instanceof Error ? error.message : `CLI ${operation} failed`,
+                    error: createErrorResponse(error instanceof Error ? error.message : `CLI ${operation} failed`, 'API_ERROR'),
                     source: 'cli',
                     mcpUsed: false
                 };
@@ -758,7 +1740,7 @@ class EnhancedMemoryClient {
         }
         catch (error) {
             return {
-                error: error instanceof Error ? error.message : 'Auth status check failed',
+                error: createErrorResponse(error instanceof Error ? error.message : 'Auth status check failed', 'API_ERROR'),
                 source: 'cli',
                 mcpUsed: false
             };
@@ -771,7 +1753,7 @@ class EnhancedMemoryClient {
         const capabilities = await this.getCapabilities();
         if (!capabilities.mcpSupport) {
             return {
-                error: 'MCP not available',
+                error: createErrorResponse('MCP not available', 'API_ERROR'),
                 source: 'cli',
                 mcpUsed: false
             };
@@ -782,7 +1764,7 @@ class EnhancedMemoryClient {
         }
         catch (error) {
             return {
-                error: error instanceof Error ? error.message : 'MCP status check failed',
+                error: createErrorResponse(error instanceof Error ? error.message : 'MCP status check failed', 'API_ERROR'),
                 source: 'cli',
                 mcpUsed: false
             };
@@ -822,218 +1804,29 @@ class EnhancedMemoryClient {
 /**
  * Factory function to create an enhanced memory client
  */
-async function createEnhancedMemoryClient(config) {
+async function createNodeMemoryClient(config) {
     const client = new EnhancedMemoryClient(config);
     await client.initialize();
     return client;
 }
 
 /**
- * Configuration utilities for Memory Client SDK
- * Provides smart defaults and environment detection for CLI/MCP integration
- */
-/**
- * Environment detection utilities
- */
-const Environment = {
-    isNode: typeof globalThis !== 'undefined' && 'process' in globalThis && globalThis.process?.versions?.node,
-    isBrowser: typeof window !== 'undefined',
-    isVSCode: typeof globalThis !== 'undefined' && 'vscode' in globalThis,
-    isCursor: typeof globalThis !== 'undefined' && 'cursor' in globalThis,
-    isWindsurf: typeof globalThis !== 'undefined' && 'windsurf' in globalThis,
-    get isIDE() {
-        return this.isVSCode || this.isCursor || this.isWindsurf;
-    },
-    get supportsCLI() {
-        return Boolean(this.isNode && !this.isBrowser);
-    }
-};
-/**
- * Create smart configuration with environment-aware defaults
- */
-function createSmartConfig(baseConfig, options = {}) {
-    const defaults = {
-        preferCLI: Environment.supportsCLI,
-        minCLIVersion: '1.5.2',
-        enableMCP: true,
-        cliDetectionTimeout: 3000,
-        verbose: false
-    };
-    const config = { ...defaults, ...options };
-    const preferCLI = config.preferCLI ?? defaults.preferCLI ?? false;
-    const minCLIVersion = config.minCLIVersion ?? defaults.minCLIVersion ?? '1.5.2';
-    const enableMCP = config.enableMCP ?? defaults.enableMCP ?? true;
-    const cliDetectionTimeout = config.cliDetectionTimeout ?? defaults.cliDetectionTimeout ?? 3000;
-    const verbose = config.verbose ?? defaults.verbose ?? false;
-    return {
-        ...baseConfig,
-        preferCLI,
-        minCLIVersion,
-        enableMCP,
-        cliDetectionTimeout,
-        verbose,
-        // Smart API configuration with environment detection
-        apiUrl: baseConfig.apiUrl || (process?.env?.NODE_ENV === 'development'
-            ? 'http://localhost:3001'
-            : 'https://api.lanonasis.com'),
-        // Default timeout based on environment
-        timeout: baseConfig.timeout || (Environment.isIDE ? 10000 : 15000)
-    };
-}
-/**
- * Preset configurations for common scenarios
- */
-const ConfigPresets = {
-    /**
-     * Development configuration with local API and CLI preference
-     */
-    development: (apiKey) => createSmartConfig({
-        apiUrl: 'http://localhost:3001',
-        apiKey,
-        timeout: 30000
-    }, {
-        preferCLI: true,
-        verbose: true
-    }),
-    /**
-     * Production configuration optimized for performance
-     */
-    production: (apiKey) => createSmartConfig({
-        apiUrl: 'https://api.lanonasis.com',
-        apiKey,
-        timeout: 15000
-    }, {
-        preferCLI: Environment.supportsCLI,
-        verbose: false
-    }),
-    /**
-     * IDE extension configuration with MCP prioritization
-     */
-    ideExtension: (apiKey) => createSmartConfig({
-        apiUrl: 'https://api.lanonasis.com',
-        apiKey,
-        timeout: 10000
-    }, {
-        preferCLI: true,
-        enableMCP: true,
-        cliDetectionTimeout: 2000
-    }),
-    /**
-     * Browser-only configuration (no CLI support)
-     */
-    browserOnly: (apiKey) => createSmartConfig({
-        apiUrl: 'https://api.lanonasis.com',
-        apiKey,
-        timeout: 15000
-    }, {
-        preferCLI: false,
-        enableMCP: false
-    }),
-    /**
-     * CLI-first configuration for server environments
-     */
-    serverCLI: (apiKey) => createSmartConfig({
-        apiUrl: 'https://api.lanonasis.com',
-        apiKey,
-        timeout: 20000
-    }, {
-        preferCLI: true,
-        enableMCP: true,
-        verbose: false
-    })
-};
-/**
- * Migration helper for existing MemoryClient users
+ * @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
  */
-function migrateToEnhanced(existingConfig, enhancementOptions = {}) {
-    return createSmartConfig(existingConfig, {
-        preferCLI: Environment.supportsCLI,
-        ...enhancementOptions
-    });
-}
+// Enhanced client with CLI support
 
-/**
- * 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()
+var index = /*#__PURE__*/Object.freeze({
+    __proto__: null,
+    CLIIntegration: CLIIntegration,
+    EnhancedMemoryClient: EnhancedMemoryClient,
+    createNodeMemoryClient: createNodeMemoryClient
 });
 
-/**
- * @lanonasis/memory-client
- *
- * Memory as a Service (MaaS) Client SDK for Lanonasis
- * Intelligent memory management with semantic search capabilities
- */
-// Main client
-// Constants
-const VERSION = '1.0.0';
-const CLIENT_NAME = '@lanonasis/memory-client';
-// Environment detection
-const isBrowser = typeof window !== 'undefined';
-const isNode = typeof globalThis !== 'undefined' && 'process' in globalThis && globalThis.process?.versions?.node;
-// Default configurations for different environments
-const defaultConfigs = {
-    development: {
-        apiUrl: 'http://localhost:3001',
-        timeout: 30000,
-        useGateway: false
-    },
-    production: {
-        apiUrl: 'https://api.lanonasis.com',
-        timeout: 15000,
-        useGateway: true
-    },
-    gateway: {
-        apiUrl: 'https://api.lanonasis.com',
-        timeout: 10000,
-        useGateway: true
-    }
-};
-// Utility functions will be added in a future version to avoid circular imports
-
-export { CLIENT_NAME, CLIIntegration, ConfigPresets, EnhancedMemoryClient, Environment, MEMORY_STATUSES, MEMORY_TYPES, MemoryClient, VERSION, createEnhancedMemoryClient, createMemoryClient, createMemorySchema, createSmartConfig, createTopicSchema, defaultConfigs, isBrowser, isNode, migrateToEnhanced, searchMemorySchema, updateMemorySchema };
+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