@yamo/memory-mesh 3.0.0 → 3.0.2

package/README.md

@@ -217,9 +217,15 @@ LANCEDB_MEMORY_TABLE=memory_entries
 
 ```bash
 # Embedding model settings
-EMBEDDING_MODEL_TYPE=local    # 'local', 'openai', 'cohere', 'ollama'
-EMBEDDING_MODEL_NAME=Xenova/all-MiniLM-L6-v2
+EMBEDDING_MODEL_TYPE=local    # 'local', 'ollama', 'openai', 'cohere'
+
+# Recommended: Gemma-300m for v3.0 Singularity Fidelity (matches OpenClaw)
+EMBEDDING_MODEL_NAME=hf_ggml-org_embeddinggemma-300m-qat-Q8_0.gguf
 EMBEDDING_DIMENSION=384
+
+# Lightweight Default (fallback)
+# EMBEDDING_MODEL_NAME=Xenova/all-MiniLM-L6-v2
+# EMBEDDING_DIMENSION=384
 ```
 
 ### Example .env File
@@ -239,7 +245,7 @@ LANCEDB_URI=./data/lancedb
 
 # Embeddings (local default)
 EMBEDDING_MODEL_TYPE=local
-EMBEDDING_MODEL_NAME=Xenova/all-MiniLM-L6-v2
+EMBEDDING_MODEL_NAME=hf_ggml-org_embeddinggemma-300m-qat-Q8_0.gguf
 ```
 
 

package/bin/memory_mesh.js

@@ -1,14 +1,101 @@
 #!/usr/bin/env node
 
 /**
- * MemoryMesh CLI Entry Point
- * Delegates to the core CLI handler in lib/memory/memory-mesh.js
+ * YAMO MemoryMesh CLI - Protocol-Native Edition (v3.1.0)
+ * 
+ * Enforces the "Zero JSON" mandate by using standard CLI flags.
+ * Machines don't parse YAMO; they execute commands.
  */
 
-import { run } from '@yamo/memory-mesh';
+import { Command } from 'commander';
+import { MemoryMesh } from '../lib/memory/index.js';
+import { createLogger } from '../lib/utils/logger.js';
 
-// Execute the main CLI handler
-run().catch(err => {
-  console.error(`❌ Fatal Error: ${err.message}`);
-  process.exit(1);
-});
+const logger = createLogger('memory-mesh-cli');
+const program = new Command();
+
+program
+  .name('memory-mesh')
+  .description('Portable semantic memory subconscious for YAMO agents')
+  .version('3.1.0');
+
+// 1. Store/Ingest Command
+program
+  .command('store')
+  .alias('ingest')
+  .description('Persist a semantic memory')
+  .requiredOption('-c, --content <text>', 'The memory content')
+  .option('-t, --type <type>', 'Memory type (e.g., insight, decision, error)', 'event')
+  .option('-r, --rationale <text>', 'The constitutional rationale for this memory')
+  .option('-h, --hypothesis <text>', 'The associated hypothesis')
+  .option('--metadata <json>', 'Additional metadata (as flat flags or optional JSON)', '{}')
+  .action(async (options) => {
+    const mesh = new MemoryMesh();
+    try {
+      let metadata = {};
+      try {
+        metadata = JSON.parse(options.metadata);
+      } catch (_e) {
+        // Fallback to empty if invalid JSON
+      }
+      
+      if (options.type) metadata.type = options.type;
+      if (options.rationale) metadata.rationale = options.rationale;
+      if (options.hypothesis) metadata.hypothesis = options.hypothesis;
+      
+      const record = await mesh.add(options.content, metadata);
+      process.stdout.write(`[MemoryMesh] Ingested record ${record.id}\n`);
+    } catch (err) {
+      console.error(`❌ Error: ${err.message}`);
+      process.exit(1);
+    } finally {
+      await mesh.close();
+    }
+  });
+
+// 2. Search Command
+program
+  .command('search')
+  .description('Perform semantic recall')
+  .argument('<query>', 'The semantic search query')
+  .option('-l, --limit <number>', 'Number of results', '10')
+  .option('-f, --filter <string>', 'LanceDB SQL-style filter')
+  .action(async (query, options) => {
+    const mesh = new MemoryMesh();
+    try {
+      const results = await mesh.search(query, {
+        limit: parseInt(options.limit),
+        filter: options.filter || null
+      });
+      
+      process.stdout.write(`[MemoryMesh] Found ${results.length} matches.\n`);
+      process.stdout.write(mesh.formatResults(results));
+      process.stdout.write('\n');
+    } catch (err) {
+      console.error(`❌ Error: ${err.message}`);
+      process.exit(1);
+    } finally {
+      await mesh.close();
+    }
+  });
+
+// 3. Stats Command
+program
+  .command('stats')
+  .description('Get database health and statistics')
+  .action(async () => {
+    const mesh = new MemoryMesh();
+    try {
+      const stats = await mesh.stats();
+      process.stdout.write(`[MemoryMesh] Total Memories: ${stats.count}\n`);
+      process.stdout.write(`[MemoryMesh] DB Path: ${stats.uri}\n`);
+      process.stdout.write(`[MemoryMesh] Status: ${stats.isConnected ? 'Connected' : 'Disconnected'}\n`);
+    } catch (err) {
+      console.error(`❌ Error: ${err.message}`);
+      process.exit(1);
+    } finally {
+      await mesh.close();
+    }
+  });
+
+program.parse();

package/lib/llm/client.d.ts

@@ -1,103 +1,78 @@
-/**
- * LLM Client - Multi-provider LLM API client for reflection generation
- *
- * Supports:
- * - OpenAI (GPT-4, GPT-4o-mini, etc.)
- * - Anthropic (Claude)
- * - Ollama (local models)
- * - Graceful fallback when LLM unavailable
- */
-export interface LLMConfig {
-    provider?: string;
-    apiKey?: string;
-    model?: string;
-    baseUrl?: string;
-    timeout?: number;
-    maxRetries?: number;
-    maxTokens?: number;
-}
-export interface ReflectionResult {
-    reflection: string;
-    confidence: number;
-}
-export interface LLMStats {
-    totalRequests: number;
-    successfulRequests: number;
-    failedRequests: number;
-    fallbackCount: number;
-}
 /**
  * LLMClient provides unified interface for calling various LLM providers
  * to generate reflections from memory contexts.
  */
 export declare class LLMClient {
-    provider: string;
-    apiKey: string;
-    model: string;
-    baseUrl: string;
-    timeout: number;
-    maxRetries: number;
-    maxTokens: number;
-    stats: LLMStats;
+    provider: any;
+    apiKey: any;
+    model: any;
+    baseUrl: any;
+    timeout: any;
+    maxRetries: any;
+    maxTokens: any;
+    stats: any;
     /**
      * Create a new LLMClient instance
      */
-    constructor(config?: LLMConfig);
+    constructor(config?: {});
     /**
      * Get default model for provider
      * @private
      */
-    _getDefaultModel(): string;
+    _getDefaultModel(): any;
     /**
      * Get default base URL for provider
      * @private
      */
-    _getDefaultBaseUrl(): string;
+    _getDefaultBaseUrl(): any;
     /**
      * Generate reflection from memories
      * Main entry point for reflection generation
      */
-    reflect(prompt: string, memories: any[]): Promise<ReflectionResult>;
+    reflect(prompt: any, memories: any): Promise<any>;
     /**
      * Format memories for LLM consumption
      * @private
      */
-    _formatMemoriesForLLM(prompt: string, memories: any[]): string;
+    _formatMemoriesForLLM(prompt: any, memories: any): string;
     /**
      * Call LLM with retry logic
      * @private
      */
-    _callWithRetry(systemPrompt: string, userContent: string): Promise<string>;
+    _callWithRetry(systemPrompt: any, userContent: any): Promise<any>;
     /**
      * Call LLM based on provider
      * @private
      */
-    _callLLM(systemPrompt: string, userContent: string): Promise<string>;
+    _callLLM(systemPrompt: any, userContent: any): Promise<any>;
     /**
      * Call OpenAI API
      * @private
      */
-    _callOpenAI(systemPrompt: string, userContent: string): Promise<string>;
+    _callOpenAI(systemPrompt: any, userContent: any): Promise<any>;
     /**
      * Call Anthropic (Claude) API
      * @private
      */
-    _callAnthropic(systemPrompt: string, userContent: string): Promise<string>;
+    _callAnthropic(systemPrompt: any, userContent: any): Promise<any>;
     /**
      * Call Ollama (local) API
      * @private
      */
-    _callOllama(systemPrompt: string, userContent: string): Promise<string>;
+    _callOllama(systemPrompt: any, userContent: any): Promise<any>;
     /**
      * Fallback when LLM fails
      * @private
      */
-    _fallback(reason: string, memories?: any[]): ReflectionResult;
+    _fallback(reason: any, memories?: any[]): {
+        reflection: string;
+        confidence: number;
+    };
     /**
      * Sleep utility
      * @private
      */
-    _sleep(ms: number): Promise<void>;
+    _sleep(ms: any): Promise<unknown>;
     /**
      * Get client statistics
      * @returns {Object} Statistics

package/lib/llm/client.js

@@ -1,3 +1,4 @@
+// @ts-nocheck
 /**
  * LLM Client - Multi-provider LLM API client for reflection generation
  *