@lanonasis/mem-intel-sdk 1.0.0 → 1.1.0

package/CHANGELOG.md

@@ -5,9 +5,25 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [1.0.1] - 2025-12-18
+
+### Fixed
+
+- Fixed TypeScript compilation errors with OpenAI SDK named imports
+- Added proper JSX configuration to tsconfig.json for React components
+- Added type annotations for callback parameters to satisfy strict TypeScript checks
+- Removed unused type imports that were causing compilation warnings
+
+### Improved
+
+- Enhanced type safety across core client and utility functions
+- Improved error messages in core error classes
+- Better handling of OpenAI client initialization
+
 ## [1.0.0] - 2024-12-17
 
 ### Added
+
 - Initial release of `@lanonasis/mem-intel-sdk`
 - Core `MemoryIntelligenceClient` with API-based architecture
 - Framework integrations:

package/README.md

@@ -37,16 +37,19 @@ pnpm add @lanonasis/mem-intel-sdk
 ### Framework-specific peer dependencies
 
 For React applications:
+
 ```bash
 npm install react @tanstack/react-query
 ```
 
 For Vue applications:
+
 ```bash
 npm install vue
 ```
 
 For MCP Server:
+
 ```bash
 npm install @modelcontextprotocol/sdk
 ```
@@ -56,15 +59,15 @@ npm install @modelcontextprotocol/sdk
 ### Basic Usage
 
 ```typescript
-import { MemoryIntelligenceClient } from '@lanonasis/mem-intel-sdk';
+import { MemoryIntelligenceClient } from "@lanonasis/mem-intel-sdk";
 
 const client = new MemoryIntelligenceClient({
-  apiKey: 'lano_xxxxxxxxxx', // Your Lanonasis API key
+  apiKey: "lano_xxxxxxxxxx", // Your Lanonasis API key
 });
 
 // Analyze memory patterns
 const analysis = await client.analyzePatterns({
-  userId: 'user-123',
+  userId: "user-123",
   timeRangeDays: 30,
 });
 
@@ -74,7 +77,7 @@ console.log(`Total memories: ${analysis.total_memories}`);
 ### Node.js with Environment Variables
 
 ```typescript
-import { NodeMemoryIntelligenceClient } from '@lanonasis/mem-intel-sdk/node';
+import { NodeMemoryIntelligenceClient } from "@lanonasis/mem-intel-sdk/node";
 
 // Automatically reads LANONASIS_API_KEY from environment
 const client = NodeMemoryIntelligenceClient.fromEnv();
@@ -83,12 +86,15 @@ const client = NodeMemoryIntelligenceClient.fromEnv();
 ### React Integration
 
 ```tsx
-import { MemoryIntelligenceProvider, usePatternAnalysis } from '@lanonasis/mem-intel-sdk/react';
+import {
+  MemoryIntelligenceProvider,
+  usePatternAnalysis,
+} from "@lanonasis/mem-intel-sdk/react";
 
 // Wrap your app
 function App() {
   return (
-    <MemoryIntelligenceProvider config={{ apiKey: 'lano_xxx' }}>
+    <MemoryIntelligenceProvider config={{ apiKey: "lano_xxx" }}>
       <Dashboard />
     </MemoryIntelligenceProvider>
   );
@@ -97,7 +103,7 @@ function App() {
 // Use hooks in components
 function Dashboard() {
   const { data, isLoading } = usePatternAnalysis({
-    userId: 'user-123',
+    userId: "user-123",
     timeRangeDays: 30,
   });
 
@@ -110,12 +116,12 @@ function Dashboard() {
 
 ```vue
 <script setup>
-import { usePatternAnalysis } from '@lanonasis/mem-intel-sdk/vue';
+import { usePatternAnalysis } from "@lanonasis/mem-intel-sdk/vue";
 
 const { data, loading, execute } = usePatternAnalysis();
 
 onMounted(() => {
-  execute({ userId: 'user-123', timeRangeDays: 30 });
+  execute({ userId: "user-123", timeRangeDays: 30 });
 });
 </script>
 ```
@@ -133,19 +139,24 @@ This SDK is designed to **complement** your existing `@lanonasis/mcp-core` infra
 ## Why This SDK?
 
 ### Modern MCP Patterns
+
 Uses the latest `server.registerTool()` API with:
+
 - Zod schema validation
 - Structured content output
 - Proper tool annotations
 - Both JSON and Markdown response formats
 
 ### Single Responsibility
+
 Unlike monolithic servers, this focuses solely on intelligence features, making it:
+
 - Easier to maintain
 - More composable
 - Better suited for specific use cases
 
 ### Production-Ready
+
 - Streamable HTTP transport support
 - Proper error handling with actionable messages
 - Character limit enforcement
@@ -158,7 +169,7 @@ For standalone MCP server usage:
 ```bash
 # Clone the repository
 git clone https://github.com/lanonasis/memory-intelligence-engine.git
-cd memory-intelligence-engine/mem-intel-mcp-server
+cd memory-intelligence-engine/mem-intelligence-sdk
 
 # Install dependencies
 npm install
@@ -185,6 +196,7 @@ PORT=3010        # HTTP port (default: 3010)
 ## Usage
 
 ### Stdio Mode (Default)
+
 ```bash
 # Development
 npm run dev
@@ -194,6 +206,7 @@ npm start
 ```
 
 ### HTTP Mode
+
 ```bash
 # Development
 npm run dev:http
@@ -205,6 +218,7 @@ npm run start:http
 ## Available Tools
 
 ### 1. `memory_analyze_patterns`
+
 Analyze usage patterns and trends in your memory collection.
 
 ```json
@@ -216,6 +230,7 @@ Analyze usage patterns and trends in your memory collection.
 ```
 
 **Returns:**
+
 - Memory distribution by type and time
 - Peak activity periods
 - Tag frequency analysis
@@ -224,6 +239,7 @@ Analyze usage patterns and trends in your memory collection.
 ---
 
 ### 2. `memory_suggest_tags`
+
 Get AI-powered tag suggestions for a memory.
 
 ```json
@@ -236,6 +252,7 @@ Get AI-powered tag suggestions for a memory.
 ```
 
 **Returns:**
+
 - Tag suggestions with confidence scores
 - Reasoning for each suggestion
 - Consistency with existing tag vocabulary
@@ -243,6 +260,7 @@ Get AI-powered tag suggestions for a memory.
 ---
 
 ### 3. `memory_find_related`
+
 Find semantically related memories using vector similarity.
 
 ```json
@@ -255,6 +273,7 @@ Find semantically related memories using vector similarity.
 ```
 
 **Returns:**
+
 - Related memories ranked by similarity
 - Shared tags between memories
 - Content previews
@@ -262,6 +281,7 @@ Find semantically related memories using vector similarity.
 ---
 
 ### 4. `memory_detect_duplicates`
+
 Identify potential duplicate or near-duplicate memories.
 
 ```json
@@ -273,6 +293,7 @@ Identify potential duplicate or near-duplicate memories.
 ```
 
 **Returns:**
+
 - Duplicate pairs with similarity scores
 - Recommendations (keep_newer, merge, etc.)
 - Estimated storage savings
@@ -280,6 +301,7 @@ Identify potential duplicate or near-duplicate memories.
 ---
 
 ### 5. `memory_extract_insights`
+
 Extract key insights and patterns from your knowledge base.
 
 ```json
@@ -292,6 +314,7 @@ Extract key insights and patterns from your knowledge base.
 ```
 
 **Returns:**
+
 - Categorized insights (patterns, learnings, opportunities, risks, action items)
 - Supporting evidence from memories
 - Confidence scores
@@ -300,6 +323,7 @@ Extract key insights and patterns from your knowledge base.
 ---
 
 ### 6. `memory_health_check`
+
 Analyze the organization quality of your memory collection.
 
 ```json
@@ -310,6 +334,7 @@ Analyze the organization quality of your memory collection.
 ```
 
 **Returns:**
+
 - Overall health score (0-100)
 - Embedding coverage
 - Tagging consistency
@@ -409,10 +434,12 @@ Tools return actionable error messages:
 ```json
 {
   "isError": true,
-  "content": [{
-    "type": "text",
-    "text": "Error analyzing patterns: Database connection failed. Try checking your ONASIS_SUPABASE_URL environment variable."
-  }]
+  "content": [
+    {
+      "type": "text",
+      "text": "Error analyzing patterns: Database connection failed. Try checking your ONASIS_SUPABASE_URL environment variable."
+    }
+  ]
 }
 ```
 
@@ -426,6 +453,7 @@ Tools return actionable error messages:
 ## Prerequisites
 
 Your Supabase database must have:
+
 1. `memory_entries` table with `embedding` column (vector)
 2. `match_memories` RPC function for vector similarity search
 3. Standard LanOnasis schema (id, title, content, type, tags, etc.)
@@ -434,13 +462,13 @@ Your Supabase database must have:
 
 ### vs. Embedding in Core Server
 
-| Aspect | Monolithic | Intelligence Server |
-|--------|-----------|---------------------|
-| **Deployment** | Single point of failure | Independent scaling |
-| **Updates** | Risk to core functionality | Safe to iterate |
-| **Resource Usage** | Shared memory/CPU | Dedicated resources |
-| **Testing** | Complex integration tests | Focused unit tests |
-| **Reusability** | Tied to LanOnasis | Portable to other projects |
+| Aspect             | Monolithic                 | Intelligence Server        |
+| ------------------ | -------------------------- | -------------------------- |
+| **Deployment**     | Single point of failure    | Independent scaling        |
+| **Updates**        | Risk to core functionality | Safe to iterate            |
+| **Resource Usage** | Shared memory/CPU          | Dedicated resources        |
+| **Testing**        | Complex integration tests  | Focused unit tests         |
+| **Reusability**    | Tied to LanOnasis          | Portable to other projects |
 
 ## Future Enhancements
 
@@ -473,6 +501,7 @@ To publish to GitHub Packages, update `.npmrc`:
 ```
 
 Then publish:
+
 ```bash
 npm publish --access public
 ```

package/dist/core/client.d.ts

@@ -1,12 +1,33 @@
 /**
  * Core Memory Intelligence Client
+ * Supports API-first with offline-fallback capability
  */
-import { MemoryIntelligenceConfig, AnalyzePatternsParams, PatternAnalysis, SuggestTagsParams, TagSuggestionsResult, FindRelatedParams, RelatedMemoriesResult, DetectDuplicatesParams, DuplicatesResult, ExtractInsightsParams, InsightsResult, HealthCheckParams, MemoryHealth, QueryMemoriesOptions, MemoryEntry } from "./types";
-import { HttpClient } from "../utils/http-client";
+import { MemoryIntelligenceConfig, AnalyzePatternsParams, PatternAnalysis, SuggestTagsParams, TagSuggestionsResult, FindRelatedParams, RelatedMemoriesResult, DetectDuplicatesParams, DuplicatesResult, ExtractInsightsParams, InsightsResult, HealthCheckParams, MemoryHealth, QueryMemoriesOptions, MemoryEntry, ProcessingMode } from "./types.js";
+import { HttpClient } from "../utils/http-client.js";
+import { UsageInfo, TierInfo } from "../utils/response-adapter.js";
+export interface IntelligenceResponse<T> {
+    data: T;
+    usage?: UsageInfo;
+    tier_info?: TierInfo;
+    fromCache?: boolean;
+}
 export declare class MemoryIntelligenceClient {
     private httpClient;
     private defaultResponseFormat;
+    private processingMode;
     constructor(config: MemoryIntelligenceConfig);
+    /**
+     * Get the current processing mode
+     */
+    getProcessingMode(): ProcessingMode;
+    /**
+     * Check if cache is enabled (for offline-fallback mode)
+     */
+    isCacheEnabled(): boolean;
+    /**
+     * Clear the response cache
+     */
+    clearCache(): void;
     /**
      * Get HTTP client for direct API access
      */
@@ -18,26 +39,26 @@ export declare class MemoryIntelligenceClient {
     /**
      * Analyze usage patterns and trends in memory collection
      */
-    analyzePatterns(params: AnalyzePatternsParams): Promise<PatternAnalysis>;
+    analyzePatterns(params: AnalyzePatternsParams): Promise<IntelligenceResponse<PatternAnalysis>>;
     /**
      * Get AI-powered tag suggestions for a memory
      */
-    suggestTags(params: SuggestTagsParams): Promise<TagSuggestionsResult>;
+    suggestTags(params: SuggestTagsParams): Promise<IntelligenceResponse<TagSuggestionsResult>>;
     /**
      * Find semantically related memories using vector similarity
      */
-    findRelated(params: FindRelatedParams): Promise<RelatedMemoriesResult>;
+    findRelated(params: FindRelatedParams): Promise<IntelligenceResponse<RelatedMemoriesResult>>;
     /**
      * Detect potential duplicate memories
      */
-    detectDuplicates(params: DetectDuplicatesParams): Promise<DuplicatesResult>;
+    detectDuplicates(params: DetectDuplicatesParams): Promise<IntelligenceResponse<DuplicatesResult>>;
     /**
      * Extract insights and patterns from memories
      */
-    extractInsights(params: ExtractInsightsParams): Promise<InsightsResult>;
+    extractInsights(params: ExtractInsightsParams): Promise<IntelligenceResponse<InsightsResult>>;
     /**
      * Check the health and organization quality of memories
      */
-    healthCheck(params: HealthCheckParams): Promise<MemoryHealth>;
+    healthCheck(params: HealthCheckParams): Promise<IntelligenceResponse<MemoryHealth>>;
 }
 //# sourceMappingURL=client.d.ts.map

package/dist/core/client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/core/client.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EACL,wBAAwB,EACxB,qBAAqB,EACrB,eAAe,EACf,iBAAiB,EACjB,oBAAoB,EACpB,iBAAiB,EACjB,qBAAqB,EACrB,sBAAsB,EACtB,gBAAgB,EAChB,qBAAqB,EACrB,cAAc,EACd,iBAAiB,EACjB,YAAY,EACZ,oBAAoB,EACpB,WAAW,EACZ,MAAM,SAAS,CAAC;AAEjB,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAIlD,qBAAa,wBAAwB;IACnC,OAAO,CAAC,UAAU,CAAa;IAC/B,OAAO,CAAC,qBAAqB,CAAsB;gBAEvC,MAAM,EAAE,wBAAwB;IAkB5C;;OAEG;IACI,aAAa,IAAI,UAAU;IAIlC;;OAEG;IACU,aAAa,CACxB,MAAM,EAAE,MAAM,EACd,OAAO,GAAE,oBAAyB,GACjC,OAAO,CAAC,WAAW,EAAE,CAAC;IAwBzB;;OAEG;IACG,eAAe,CAAC,MAAM,EAAE,qBAAqB,GAAG,OAAO,CAAC,eAAe,CAAC;IAgB9E;;OAEG;IACG,WAAW,CAAC,MAAM,EAAE,iBAAiB,GAAG,OAAO,CAAC,oBAAoB,CAAC;IAgB3E;;OAEG;IACG,WAAW,CAAC,MAAM,EAAE,iBAAiB,GAAG,OAAO,CAAC,qBAAqB,CAAC;IAgB5E;;OAEG;IACG,gBAAgB,CAAC,MAAM,EAAE,sBAAsB,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAgBjF;;OAEG;IACG,eAAe,CAAC,MAAM,EAAE,qBAAqB,GAAG,OAAO,CAAC,cAAc,CAAC;IAgB7E;;OAEG;IACG,WAAW,CAAC,MAAM,EAAE,iBAAiB,GAAG,OAAO,CAAC,YAAY,CAAC;CAepE"}
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/core/client.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EACL,wBAAwB,EACxB,qBAAqB,EACrB,eAAe,EACf,iBAAiB,EACjB,oBAAoB,EACpB,iBAAiB,EACjB,qBAAqB,EACrB,sBAAsB,EACtB,gBAAgB,EAChB,qBAAqB,EACrB,cAAc,EACd,iBAAiB,EACjB,YAAY,EACZ,oBAAoB,EACpB,WAAW,EACX,cAAc,EACf,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AACrD,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,8BAA8B,CAAC;AAInE,MAAM,WAAW,oBAAoB,CAAC,CAAC;IACrC,IAAI,EAAE,CAAC,CAAC;IACR,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,SAAS,CAAC,EAAE,QAAQ,CAAC;IACrB,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,qBAAa,wBAAwB;IACnC,OAAO,CAAC,UAAU,CAAa;IAC/B,OAAO,CAAC,qBAAqB,CAAsB;IACnD,OAAO,CAAC,cAAc,CAAiB;gBAE3B,MAAM,EAAE,wBAAwB;IAuB5C;;OAEG;IACH,iBAAiB,IAAI,cAAc;IAInC;;OAEG;IACH,cAAc,IAAI,OAAO;IAIzB;;OAEG;IACH,UAAU,IAAI,IAAI;IAIlB;;OAEG;IACI,aAAa,IAAI,UAAU;IAIlC;;OAEG;IACU,aAAa,CACxB,MAAM,EAAE,MAAM,EACd,OAAO,GAAE,oBAAyB,GACjC,OAAO,CAAC,WAAW,EAAE,CAAC;IAwBzB;;OAEG;IACG,eAAe,CAAC,MAAM,EAAE,qBAAqB,GAAG,OAAO,CAAC,oBAAoB,CAAC,eAAe,CAAC,CAAC;IAqBpG;;OAEG;IACG,WAAW,CAAC,MAAM,EAAE,iBAAiB,GAAG,OAAO,CAAC,oBAAoB,CAAC,oBAAoB,CAAC,CAAC;IAqBjG;;OAEG;IACG,WAAW,CAAC,MAAM,EAAE,iBAAiB,GAAG,OAAO,CAAC,oBAAoB,CAAC,qBAAqB,CAAC,CAAC;IAqBlG;;OAEG;IACG,gBAAgB,CAAC,MAAM,EAAE,sBAAsB,GAAG,OAAO,CAAC,oBAAoB,CAAC,gBAAgB,CAAC,CAAC;IAqBvG;;OAEG;IACG,eAAe,CAAC,MAAM,EAAE,qBAAqB,GAAG,OAAO,CAAC,oBAAoB,CAAC,cAAc,CAAC,CAAC;IAqBnG;;OAEG;IACG,WAAW,CAAC,MAAM,EAAE,iBAAiB,GAAG,OAAO,CAAC,oBAAoB,CAAC,YAAY,CAAC,CAAC;CAoB1F"}