@lanonasis/mem-intel-sdk 1.0.1 → 2.0.0

package/dist/core/index.cjs

@@ -42,12 +42,120 @@ var ValidationError = class extends MemoryIntelligenceError {
   }
 };
 
+// src/utils/response-adapter.ts
+function adaptEdgeFunctionResponse(httpResponse) {
+  if (httpResponse.error) {
+    return {
+      status: httpResponse.status,
+      error: httpResponse.error
+    };
+  }
+  const envelope = httpResponse.data;
+  if (!envelope) {
+    return {
+      status: httpResponse.status,
+      error: {
+        message: "Empty response from server",
+        code: "EMPTY_RESPONSE"
+      }
+    };
+  }
+  if (!envelope.success && envelope.error) {
+    return {
+      status: httpResponse.status,
+      error: envelope.error,
+      usage: envelope.usage,
+      tier_info: envelope.tier_info
+    };
+  }
+  return {
+    status: httpResponse.status,
+    data: envelope.data,
+    usage: envelope.usage,
+    tier_info: envelope.tier_info
+  };
+}
+function isEdgeFunctionEnvelope(data) {
+  if (typeof data !== "object" || data === null) {
+    return false;
+  }
+  const obj = data;
+  return "success" in obj && typeof obj.success === "boolean";
+}
+function adaptResponse(httpResponse) {
+  if (httpResponse.error) {
+    return {
+      status: httpResponse.status,
+      error: httpResponse.error
+    };
+  }
+  const responseData = httpResponse.data;
+  if (isEdgeFunctionEnvelope(responseData)) {
+    return adaptEdgeFunctionResponse({
+      status: httpResponse.status,
+      data: responseData
+    });
+  }
+  return {
+    status: httpResponse.status,
+    data: responseData
+  };
+}
+var ResponseCache = class {
+  cache = /* @__PURE__ */ new Map();
+  ttl;
+  constructor(ttlMs = 3e5) {
+    this.ttl = ttlMs;
+  }
+  generateKey(endpoint, params) {
+    const paramStr = params ? JSON.stringify(params) : "";
+    return `${endpoint}:${paramStr}`;
+  }
+  set(endpoint, data, params) {
+    const key = this.generateKey(endpoint, params);
+    this.cache.set(key, {
+      data,
+      timestamp: Date.now(),
+      endpoint,
+      params
+    });
+  }
+  get(endpoint, params) {
+    const key = this.generateKey(endpoint, params);
+    const entry = this.cache.get(key);
+    if (!entry) {
+      return null;
+    }
+    if (Date.now() - entry.timestamp > this.ttl) {
+      this.cache.delete(key);
+      return null;
+    }
+    return entry.data;
+  }
+  clear() {
+    this.cache.clear();
+  }
+  /**
+   * Clean up expired entries
+   */
+  cleanup() {
+    const now = Date.now();
+    for (const [key, entry] of this.cache.entries()) {
+      if (now - entry.timestamp > this.ttl) {
+        this.cache.delete(key);
+      }
+    }
+  }
+};
+
 // src/utils/http-client.ts
 var HttpClient = class {
   apiUrl;
   apiKey;
   timeout;
   headers;
+  processingMode;
+  cache;
   constructor(config) {
     if (!config.apiKey) {
       throw new ConfigurationError("API key is required");
@@ -60,11 +168,35 @@ var HttpClient = class {
     this.apiUrl = config.apiUrl.replace(/\/$/, "");
     this.apiKey = config.apiKey;
     this.timeout = config.timeout || 3e4;
+    this.processingMode = config.processingMode || "api";
     this.headers = {
       "Content-Type": "application/json",
       "X-API-Key": this.apiKey,
       ...config.headers
     };
+    if (config.enableCache !== false && this.processingMode === "offline-fallback") {
+      this.cache = new ResponseCache(config.cacheTTL || 3e5);
+    } else {
+      this.cache = null;
+    }
+  }
+  /**
+   * Get the current processing mode
+   */
+  getProcessingMode() {
+    return this.processingMode;
+  }
+  /**
+   * Check if cache is enabled
+   */
+  isCacheEnabled() {
+    return this.cache !== null;
+  }
+  /**
+   * Clear the response cache
+   */
+  clearCache() {
+    this.cache?.clear();
   }
   async request(method, endpoint, data) {
     const url = `${this.apiUrl}${endpoint}`;
@@ -124,6 +256,43 @@ var HttpClient = class {
       };
     }
   }
+  /**
+   * Enhanced request that handles Edge Function envelope format
+   * and supports offline-fallback caching
+   */
+  async enhancedRequest(method, endpoint, data) {
+    const cacheKey = data ? JSON.stringify(data) : void 0;
+    const rawResponse = await this.request(method, endpoint, data);
+    if (rawResponse.error?.code === "NETWORK_ERROR" || rawResponse.error?.code === "TIMEOUT") {
+      if (this.processingMode === "offline-fallback" && this.cache) {
+        const cached = this.cache.get(endpoint, cacheKey ? JSON.parse(cacheKey) : void 0);
+        if (cached) {
+          return {
+            status: 200,
+            data: cached,
+            fromCache: true
+          };
+        }
+      }
+      return {
+        status: rawResponse.status,
+        error: rawResponse.error,
+        fromCache: false
+      };
+    }
+    const adapted = adaptResponse(rawResponse);
+    if (!adapted.error && adapted.data && this.cache) {
+      this.cache.set(endpoint, adapted.data, cacheKey ? JSON.parse(cacheKey) : void 0);
+    }
+    return {
+      status: adapted.status,
+      data: adapted.data,
+      error: adapted.error,
+      usage: adapted.usage,
+      tier_info: adapted.tier_info,
+      fromCache: false
+    };
+  }
   async get(endpoint) {
     return this.request("GET", endpoint);
   }
@@ -139,6 +308,22 @@ var HttpClient = class {
   async delete(endpoint) {
     return this.request("DELETE", endpoint);
   }
+  // Enhanced methods with Edge Function envelope support
+  async getEnhanced(endpoint) {
+    return this.enhancedRequest("GET", endpoint);
+  }
+  async postEnhanced(endpoint, data) {
+    return this.enhancedRequest("POST", endpoint, data);
+  }
+  async putEnhanced(endpoint, data) {
+    return this.enhancedRequest("PUT", endpoint, data);
+  }
+  async patchEnhanced(endpoint, data) {
+    return this.enhancedRequest("PATCH", endpoint, data);
+  }
+  async deleteEnhanced(endpoint) {
+    return this.enhancedRequest("DELETE", endpoint);
+  }
 };
 
 // src/core/client.ts
@@ -146,20 +331,43 @@ var DEFAULT_API_URL = "https://api.lanonasis.com/api/v1";
 var MemoryIntelligenceClient = class {
   httpClient;
   defaultResponseFormat;
+  processingMode;
   constructor(config) {
     if (!config.apiKey) {
       throw new ConfigurationError(
         "Missing required configuration: apiKey is required (format: lano_xxxxxxxxxx)"
       );
     }
+    this.processingMode = config.processingMode || "api";
     this.httpClient = new HttpClient({
       apiUrl: config.apiUrl || DEFAULT_API_URL,
       apiKey: config.apiKey,
       timeout: config.timeout,
-      headers: config.headers
+      headers: config.headers,
+      processingMode: this.processingMode,
+      enableCache: config.enableCache,
+      cacheTTL: config.cacheTTL
     });
     this.defaultResponseFormat = config.responseFormat || "markdown";
   }
+  /**
+   * Get the current processing mode
+   */
+  getProcessingMode() {
+    return this.processingMode;
+  }
+  /**
+   * Check if cache is enabled (for offline-fallback mode)
+   */
+  isCacheEnabled() {
+    return this.httpClient.isCacheEnabled();
+  }
+  /**
+   * Clear the response cache
+   */
+  clearCache() {
+    this.httpClient.clearCache();
+  }
   /**
    * Get HTTP client for direct API access
    */
@@ -191,7 +399,7 @@ var MemoryIntelligenceClient = class {
    * Analyze usage patterns and trends in memory collection
    */
   async analyzePatterns(params) {
-    const response = await this.httpClient.post(
+    const response = await this.httpClient.postEnhanced(
       "/intelligence/analyze-patterns",
       {
         ...params,
@@ -201,13 +409,18 @@ var MemoryIntelligenceClient = class {
     if (response.error) {
       throw new DatabaseError(`Failed to analyze patterns: ${response.error.message}`);
     }
-    return response.data;
+    return {
+      data: response.data,
+      usage: response.usage,
+      tier_info: response.tier_info,
+      fromCache: response.fromCache
+    };
   }
   /**
    * Get AI-powered tag suggestions for a memory
    */
   async suggestTags(params) {
-    const response = await this.httpClient.post(
+    const response = await this.httpClient.postEnhanced(
       "/intelligence/suggest-tags",
       {
         ...params,
@@ -217,13 +430,18 @@ var MemoryIntelligenceClient = class {
     if (response.error) {
       throw new DatabaseError(`Failed to suggest tags: ${response.error.message}`);
     }
-    return response.data;
+    return {
+      data: response.data,
+      usage: response.usage,
+      tier_info: response.tier_info,
+      fromCache: response.fromCache
+    };
   }
   /**
    * Find semantically related memories using vector similarity
    */
   async findRelated(params) {
-    const response = await this.httpClient.post(
+    const response = await this.httpClient.postEnhanced(
       "/intelligence/find-related",
       {
         ...params,
@@ -233,13 +451,18 @@ var MemoryIntelligenceClient = class {
     if (response.error) {
       throw new DatabaseError(`Failed to find related memories: ${response.error.message}`);
     }
-    return response.data;
+    return {
+      data: response.data,
+      usage: response.usage,
+      tier_info: response.tier_info,
+      fromCache: response.fromCache
+    };
   }
   /**
    * Detect potential duplicate memories
    */
   async detectDuplicates(params) {
-    const response = await this.httpClient.post(
+    const response = await this.httpClient.postEnhanced(
       "/intelligence/detect-duplicates",
       {
         ...params,
@@ -249,13 +472,18 @@ var MemoryIntelligenceClient = class {
     if (response.error) {
       throw new DatabaseError(`Failed to detect duplicates: ${response.error.message}`);
     }
-    return response.data;
+    return {
+      data: response.data,
+      usage: response.usage,
+      tier_info: response.tier_info,
+      fromCache: response.fromCache
+    };
   }
   /**
    * Extract insights and patterns from memories
    */
   async extractInsights(params) {
-    const response = await this.httpClient.post(
+    const response = await this.httpClient.postEnhanced(
       "/intelligence/extract-insights",
       {
         ...params,
@@ -265,13 +493,18 @@ var MemoryIntelligenceClient = class {
     if (response.error) {
       throw new DatabaseError(`Failed to extract insights: ${response.error.message}`);
     }
-    return response.data;
+    return {
+      data: response.data,
+      usage: response.usage,
+      tier_info: response.tier_info,
+      fromCache: response.fromCache
+    };
   }
   /**
    * Check the health and organization quality of memories
    */
   async healthCheck(params) {
-    const response = await this.httpClient.post(
+    const response = await this.httpClient.postEnhanced(
       "/intelligence/health-check",
       {
         ...params,
@@ -281,7 +514,81 @@ var MemoryIntelligenceClient = class {
     if (response.error) {
       throw new DatabaseError(`Failed to check health: ${response.error.message}`);
     }
-    return response.data;
+    return {
+      data: response.data,
+      usage: response.usage,
+      tier_info: response.tier_info,
+      fromCache: response.fromCache
+    };
+  }
+  /**
+   * Predictive Memory Recall - AI that anticipates what you need
+   *
+   * Uses a weighted scoring algorithm:
+   *   - Semantic similarity to current context (40%)
+   *   - Temporal relevance (recency decay curve) (30%)
+   *   - Usage frequency (20%)
+   *   - Serendipity factor (adjacent discoveries) (10%)
+   *
+   * @example
+   * ```typescript
+   * const result = await client.predictiveRecall({
+   *   userId: "user-123",
+   *   context: {
+   *     currentProject: "Building dashboard components",
+   *     recentTopics: ["React", "performance", "hooks"],
+   *     contextText: "Optimizing render performance for data tables"
+   *   },
+   *   limit: 5,
+   *   minConfidence: 50
+   * });
+   *
+   * for (const prediction of result.data.predictions) {
+   *   console.log(`[${prediction.confidence}%] ${prediction.title}`);
+   *   console.log(`  Reason: ${prediction.reason}`);
+   *   console.log(`  Action: ${prediction.suggestedAction}`);
+   * }
+   * ```
+   */
+  async predictiveRecall(params) {
+    const response = await this.httpClient.postEnhanced(
+      "/intelligence/predictive-recall",
+      {
+        userId: params.userId,
+        context: params.context,
+        limit: params.limit || 5,
+        minConfidence: params.minConfidence || 40,
+        includeSerendipity: params.includeSerendipity !== false,
+        memoryTypes: params.memoryTypes,
+        timeWindowDays: params.timeWindowDays || 90,
+        responseFormat: params.responseFormat || this.defaultResponseFormat
+      }
+    );
+    if (response.error) {
+      throw new DatabaseError(`Failed to get predictions: ${response.error.message}`);
+    }
+    return {
+      data: response.data,
+      usage: response.usage,
+      tier_info: response.tier_info,
+      fromCache: response.fromCache
+    };
+  }
+  /**
+   * Record feedback on a prediction (for improving accuracy over time)
+   *
+   * @example
+   * ```typescript
+   * await client.recordPredictionFeedback({
+   *   memoryId: "mem-123",
+   *   userId: "user-123",
+   *   useful: true,
+   *   action: "clicked"
+   * });
+   * ```
+   */
+  async recordPredictionFeedback(params) {
+    await this.httpClient.post("/intelligence/prediction-feedback", params);
   }
 };
 var ResponseFormat = {
@@ -296,14 +603,54 @@ var MemoryType = zod.z.enum([
   "personal",
   "workflow"
 ]);
+var PredictiveRecallParamsSchema = zod.z.object({
+  userId: zod.z.string().uuid(),
+  context: zod.z.object({
+    currentProject: zod.z.string().optional(),
+    recentTopics: zod.z.array(zod.z.string()).optional(),
+    activeFiles: zod.z.array(zod.z.string()).optional(),
+    contextText: zod.z.string().optional(),
+    teamContext: zod.z.string().optional()
+  }),
+  limit: zod.z.number().int().min(1).max(20).default(5),
+  minConfidence: zod.z.number().min(0).max(100).default(40),
+  includeSerendipity: zod.z.boolean().default(true),
+  memoryTypes: zod.z.array(zod.z.enum([
+    "context",
+    "project",
+    "knowledge",
+    "reference",
+    "personal",
+    "workflow"
+  ])).optional(),
+  timeWindowDays: zod.z.number().int().min(1).max(365).default(90),
+  responseFormat: zod.z.enum(["json", "markdown"]).default("markdown")
+});
+var DEFAULT_SCORING_CONFIG = {
+  semanticWeight: 0.4,
+  temporalWeight: 0.3,
+  frequencyWeight: 0.2,
+  serendipityWeight: 0.1,
+  temporalDecayHalfLife: 14,
+  // 2 weeks
+  semanticThreshold: 0.5,
+  serendipityRange: {
+    min: 0.3,
+    // Not too similar
+    max: 0.6
+    // Not too different
+  }
+};
 
 exports.ConfigurationError = ConfigurationError;
+exports.DEFAULT_SCORING_CONFIG = DEFAULT_SCORING_CONFIG;
 exports.DatabaseError = DatabaseError;
 exports.EmbeddingError = EmbeddingError;
 exports.MemoryIntelligenceClient = MemoryIntelligenceClient;
 exports.MemoryIntelligenceError = MemoryIntelligenceError;
 exports.MemoryNotFoundError = MemoryNotFoundError;
 exports.MemoryType = MemoryType;
+exports.PredictiveRecallParamsSchema = PredictiveRecallParamsSchema;
 exports.ResponseFormat = ResponseFormat;
 exports.ValidationError = ValidationError;
 //# sourceMappingURL=index.cjs.map