@digitalforgestudios/openclaw-sulcus 3.0.0 → 3.1.1

package/index.ts

@@ -43,29 +43,29 @@ const FALLBACK_AWARENESS = `<sulcus_context token_budget="500">
 </sulcus_context>`;
 
 // ─── NATIVE LIB LOADER ──────────────────────────────────────────────────────
-// Loads libsulcus_store.dylib (embedded PG) and libsulcus_embed.dylib (embeddings)
+// Loads libsulcus_store.dylib (embedded PG) and libsulcus_vectors.dylib (embeddings)
 // via koffi FFI. Provides queryFn and embedFn callbacks for SulcusMem.create().
 
 class NativeLibLoader {
   private koffi: any = null;
   private storeLib: any = null;
-  private embedLib: any = null;
-  private embedHandle: any = null;
+  private vectorsLib: any = null;
+  private vectorsHandle: any = null;
 
   // koffi function handles
   private fn_store_init: any = null;
   private fn_store_query: any = null;
   private fn_store_free: any = null;
-  private fn_embed_create: any = null;
-  private fn_embed_text: any = null;
-  private fn_embed_free: any = null;
+  private fn_vectors_create: any = null;
+  private fn_vectors_text: any = null;
+  private fn_vectors_free: any = null;
 
   public loaded = false;
   public error: string | null = null;
 
   constructor(
     private storeLibPath: string,
-    private embedLibPath: string
+    private vectorsLibPath: string
   ) {}
 
   init(logger: any): void {
@@ -84,8 +84,8 @@ class NativeLibLoader {
       logger.warn(`memory-sulcus: ${this.error}`);
       return;
     }
-    if (!existsSync(this.embedLibPath)) {
-      this.error = `libsulcus_embed not found at ${this.embedLibPath}`;
+    if (!existsSync(this.vectorsLibPath)) {
+      this.error = `libsulcus_vectors not found at ${this.vectorsLibPath}`;
       logger.warn(`memory-sulcus: ${this.error}`);
       return;
     }
@@ -102,12 +102,12 @@ class NativeLibLoader {
     }
 
     try {
-      this.embedLib = this.koffi.load(this.embedLibPath);
-      this.fn_embed_create = this.embedLib.func("sulcus_embed_create", "void*",  []);
-      this.fn_embed_text   = this.embedLib.func("sulcus_embed_text",   "char*",  ["void*", "str"]);
-      this.fn_embed_free   = this.embedLib.func("sulcus_embed_free_string", "void", ["char*"]);
+      this.vectorsLib = this.koffi.load(this.vectorsLibPath);
+      this.fn_vectors_create = this.vectorsLib.func("sulcus_vectors_create", "void*",  []);
+      this.fn_vectors_text   = this.vectorsLib.func("sulcus_vectors_text",   "char*",  ["void*", "str"]);
+      this.fn_vectors_free   = this.vectorsLib.func("sulcus_vectors_free_string", "void", ["char*"]);
     } catch (e: any) {
-      this.error = `Failed to load libsulcus_embed: ${e.message}`;
+      this.error = `Failed to load libsulcus_vectors: ${e.message}`;
       logger.warn(`memory-sulcus: ${this.error}`);
       return;
     }
@@ -130,15 +130,15 @@ class NativeLibLoader {
 
     // ── Create embed handle ──
     try {
-      this.embedHandle = this.fn_embed_create();
+      this.vectorsHandle = this.fn_vectors_create();
     } catch (e: any) {
-      this.error = `sulcus_embed_create failed: ${e.message}`;
+      this.error = `sulcus_vectors_create failed: ${e.message}`;
       logger.warn(`memory-sulcus: ${this.error}`);
       return;
     }
 
     this.loaded = true;
-    logger.info(`memory-sulcus: native libs loaded (store: ${this.storeLibPath}, embed: ${this.embedLibPath})`);
+    logger.info(`memory-sulcus: native libs loaded (store: ${this.storeLibPath}, vectors: ${this.vectorsLibPath})`);
   }
 
   // queryFn: async (sql: string, params: any[]) => any[]
@@ -163,12 +163,12 @@ class NativeLibLoader {
   }
 
   // embedFn: async (text: string) => Float32Array
-  // Calls sulcus_embed_text which returns a JSON float array string.
+  // Calls sulcus_vectors_text which returns a JSON float array string.
   makeEmbedFn(): (text: string) => Promise<Float32Array> {
     return async (text: string): Promise<Float32Array> => {
-      if (!this.loaded) throw new Error("Sulcus embed not available");
-      const raw: string = this.fn_embed_text(this.embedHandle, text);
-      if (!raw) throw new Error("sulcus_embed_text returned null");
+      if (!this.loaded) throw new Error("Sulcus vectors not available");
+      const raw: string = this.fn_vectors_text(this.vectorsHandle, text);
+      if (!raw) throw new Error("sulcus_vectors_text returned null");
       const arr: number[] = JSON.parse(raw);
       return new Float32Array(arr);
     };
@@ -220,9 +220,9 @@ const sulcusPlugin = {
       ? resolve(api.config.storeLibPath)
       : resolve(libDir, process.platform === "darwin" ? "libsulcus_store.dylib" : "libsulcus_store.so");
 
-    const embedLibPath = api.config?.embedLibPath
-      ? resolve(api.config.embedLibPath)
-      : resolve(libDir, process.platform === "darwin" ? "libsulcus_embed.dylib" : "libsulcus_embed.so");
+    const vectorsLibPath = api.config?.vectorsLibPath
+      ? resolve(api.config.vectorsLibPath)
+      : resolve(libDir, process.platform === "darwin" ? "libsulcus_vectors.dylib" : "libsulcus_vectors.so");
 
     const wasmDir = api.config?.wasmDir
       ? resolve(api.config.wasmDir)
@@ -235,7 +235,7 @@ const sulcusPlugin = {
       : (api.config?.namespace || agentId || "default");
 
     // ── Load native dylibs ──
-    const nativeLoader = new NativeLibLoader(storeLibPath, embedLibPath);
+    const nativeLoader = new NativeLibLoader(storeLibPath, vectorsLibPath);
     nativeLoader.init(api.logger);
 
     // ── Load WASM module ──
@@ -288,7 +288,7 @@ const sulcusPlugin = {
           throw new Error(`Sulcus unavailable: ${nativeLoader.error || "WASM not loaded"}`);
         }
         const res = await sulcusMem.search_memory(params.query, params.limit ?? 5);
-        const results = res?.results ?? res;
+        const results = res?.results ?? res?.items ?? res?.nodes ?? res ?? [];
         return {
           content: [{ type: "text", text: JSON.stringify(results, null, 2) }],
           details: { results, backend: backendMode, namespace }
@@ -325,9 +325,11 @@ const sulcusPlugin = {
         }
 
         const res = await sulcusMem.add_memory(params.content, params.memory_type ?? null);
+        const nodeId = res?.id ?? "unknown";
+        const mtype = params.memory_type || "episodic";
         return {
-          content: [{ type: "text", text: `Stored [${params.memory_type || "episodic"}] memory: "${(params.content || "").substring(0, 80)}..." → [${backendMode}] namespace: ${namespace}` }],
-          details: { ...res, backend: backendMode, namespace }
+          content: [{ type: "text", text: `Stored [${mtype}] memory (id: ${nodeId}) → backend: ${backendMode}, namespace: ${namespace}` }],
+          details: { id: nodeId, memory_type: mtype, backend: backendMode, namespace, ...res }
         };
       }
     }, { name: "memory_store" });
@@ -346,7 +348,7 @@ const sulcusPlugin = {
               namespace,
               error: nativeLoader.error || "WASM not loaded",
               storeLib: storeLibPath,
-              embedLib: embedLibPath,
+              vectorsLib: vectorsLibPath,
               wasmDir,
             }, null, 2) }],
           };

package/openclaw.plugin.json

@@ -2,10 +2,10 @@
   "id": "openclaw-sulcus",
   "kind": "memory",
   "name": "Sulcus",
-  "description": "Reactive, thermodynamic memory for AI agents. Runs entirely local via WASM + native dylibs (embedded PostgreSQL, fastembed). No network calls. Optional cloud sync via sulcus-sync dylib when serverUrl/apiKey are configured.",
+  "description": "Reactive, thermodynamic memory for AI agents. Runs entirely local via WASM + native dylibs (embedded PostgreSQL, sulcus-vectors). No network calls. Optional cloud sync via sulcus-sync dylib when serverUrl/apiKey are configured.",
   "privacy": {
     "consentModel": "local-first",
-    "consentNote": "Plugin runs entirely in-process. No network calls. All data stays local in ~/.sulcus/. Cloud sync is opt-in via serverUrl/apiKey config, handled by sulcus-sync dylib loaded by sulcus-local.",
+    "consentNote": "Plugin runs entirely in-process. No network calls. All data stays local in ~/.sulcus/. Cloud sync is opt-in via serverUrl/apiKey config, handled by sulcus-sync dylib loaded by sulcus.",
     "crossNamespaceAccess": "local-only",
     "crossNamespaceNote": "All memory operations are local. Cross-namespace access only applies if cloud sync is configured separately.",
     "dataFlows": [
@@ -34,7 +34,7 @@
       },
       "libDir": {
         "type": "string",
-        "description": "Directory containing native dylibs (libsulcus_store, libsulcus_embed)",
+        "description": "Directory containing native dylibs (libsulcus_store, libsulcus_vectors)",
         "default": "~/.sulcus/lib"
       },
       "wasmDir": {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@digitalforgestudios/openclaw-sulcus",
-  "version": "3.0.0",
+  "version": "3.1.1",
   "description": "Sulcus — reactive, thermodynamic memory plugin for OpenClaw. Opt-in persistent memory with heat-based decay, semantic search, and cross-agent sync. Auto-recall and auto-capture disabled by default.",
   "keywords": [
     "openclaw",