@digitalforgestudios/openclaw-sulcus 3.5.2 → 3.5.4

package/index.ts

@@ -213,7 +213,7 @@ class SulcusCloudClient {
   async search_memory(query: string, limit?: number): Promise<{ results: any[] }> {
     const body: any = { query };
     if (limit !== undefined) body.limit = limit;
-    const res = await this.request("POST", "/agent/search", body);
+    const res = await this.request("POST", "/api/v1/agent/search", body);
     const results = res?.results ?? res?.items ?? res?.nodes ?? (Array.isArray(res) ? res : []);
     return { results };
   }
@@ -225,7 +225,7 @@ class SulcusCloudClient {
   async add_memory(content: string, memoryType?: string | null): Promise<{ id: string; [key: string]: any }> {
     const body: any = { text: content };
     if (memoryType) body.memory_type = memoryType;
-    const res = await this.request("POST", "/agent/nodes", body);
+    const res = await this.request("POST", "/api/v1/agent/nodes", body);
     return res ?? { id: "unknown" };
   }
 
@@ -234,7 +234,7 @@ class SulcusCloudClient {
    * Returns hot_nodes list; normalised for memory_status tool.
    */
   async list_hot_nodes(_limit?: number): Promise<{ nodes: any[] }> {
-    const res = await this.request("GET", "/agent/memory/status");
+    const res = await this.request("GET", "/api/v1/agent/memory/status");
     const nodes = res?.hot_nodes ?? res?.nodes ?? [];
     return { nodes };
   }
@@ -245,7 +245,7 @@ class SulcusCloudClient {
   async consolidate(minHeat?: number): Promise<any> {
     const body: any = {};
     if (minHeat !== undefined) body.min_heat = minHeat;
-    return this.request("POST", "/agent/consolidate", body);
+    return this.request("POST", "/api/v1/agent/consolidate", body);
   }
 
   /**
@@ -253,7 +253,7 @@ class SulcusCloudClient {
    * Returns raw markdown string.
    */
   async export_markdown(): Promise<string> {
-    const res = await this.request("GET", "/agent/export?format=markdown");
+    const res = await this.request("GET", "/api/v1/agent/export?format=markdown");
     // Server may return { content: "..." } or raw string
     if (typeof res === "string") return res;
     return res?.content ?? res?.markdown ?? JSON.stringify(res, null, 2);
@@ -263,7 +263,7 @@ class SulcusCloudClient {
    * import_markdown — maps to POST /agent/import
    */
   async import_markdown(text: string): Promise<any> {
-    return this.request("POST", "/agent/import", { format: "markdown", content: text });
+    return this.request("POST", "/api/v1/agent/import", { format: "markdown", content: text });
   }
 
   /**
@@ -278,7 +278,7 @@ class SulcusCloudClient {
         body.context = contextJson;
       }
     }
-    return this.request("POST", "/agent/triggers/evaluate", body);
+    return this.request("POST", "/api/v1/agent/triggers/evaluate", body);
   }
 }
 
@@ -770,53 +770,48 @@ const sulcusPlugin = {
     // ── Load hooks config (config-driven dispatch) ──
     const hooksConfig = loadHooksConfig(api.pluginConfig);
 
-    // ── Load native dylibs ──
-    const nativeLoader = new NativeLibLoader(storeLibPath, vectorsLibPath);
-    nativeLoader.init(api.logger);
-
-    // ── Load WASM module ──
+    // ── Backend init: cloud-first, then local ──
     let sulcusMem: any = null;
     let backendMode = "unavailable";
+    const nativeLoader = new NativeLibLoader(storeLibPath, vectorsLibPath);
 
-    if (nativeLoader.loaded) {
-      const wasmJsPath = resolve(wasmDir, "sulcus_wasm.js");
-      if (existsSync(wasmJsPath)) {
-        try {
-          const { SulcusMem, on_init } = require(wasmJsPath);
-          // on_init sets up WASM internals (panic hooks etc.)
-          if (typeof on_init === "function") on_init();
-
-          const queryFn = nativeLoader.makeQueryFn();
-          const embedFn = nativeLoader.makeEmbedFn();
-          sulcusMem = SulcusMem.create(queryFn, embedFn);
-          backendMode = "wasm";
-          api.logger.info(`sulcus: SulcusMem created via WASM (wasm: ${wasmJsPath})`);
-        } catch (e: any) {
-          api.logger.warn(`sulcus: WASM load failed: ${e.message}`);
-          backendMode = "unavailable";
-        }
-      } else {
-        api.logger.warn(`sulcus: WASM module not found at ${wasmJsPath}`);
+    // Priority 1: Cloud mode — if serverUrl + apiKey are configured, use HTTP.
+    // No local dylibs needed. This is the path for cloud-only users.
+    if (serverUrl && apiKey) {
+      try {
+        const cloudClient = new SulcusCloudClient(serverUrl, apiKey);
+        sulcusMem = cloudClient;
+        backendMode = "cloud";
+        api.logger.info(`sulcus: using cloud backend (server: ${serverUrl})`);
+      } catch (e: any) {
+        api.logger.warn(`sulcus: cloud client init failed: ${e.message}`);
       }
-    } else {
-      api.logger.warn(`sulcus: native libs unavailable — ${nativeLoader.error}`);
     }
 
-    // ── Cloud HTTP fallback ──
-    // Activates only when local WASM/native libs are unavailable AND
-    // serverUrl + apiKey are configured. Zero external dependencies.
+    // Priority 2: Local WASM+native — if cloud isn't configured or failed,
+    // try loading native dylibs + WASM module for fully local operation.
     if (sulcusMem === null) {
-      if (serverUrl && apiKey) {
-        try {
-          const cloudClient = new SulcusCloudClient(serverUrl, apiKey);
-          sulcusMem = cloudClient;
-          backendMode = "cloud";
-          api.logger.info(`sulcus: using cloud backend (server: ${serverUrl})`);
-        } catch (e: any) {
-          api.logger.warn(`sulcus: cloud client init failed: ${e.message}`);
+      nativeLoader.init(api.logger);
+      if (nativeLoader.loaded) {
+        const wasmJsPath = resolve(wasmDir, "sulcus_wasm.js");
+        if (existsSync(wasmJsPath)) {
+          try {
+            const { SulcusMem, on_init } = require(wasmJsPath);
+            if (typeof on_init === "function") on_init();
+
+            const queryFn = nativeLoader.makeQueryFn();
+            const embedFn = nativeLoader.makeEmbedFn();
+            sulcusMem = SulcusMem.create(queryFn, embedFn);
+            backendMode = "wasm";
+            api.logger.info(`sulcus: SulcusMem created via WASM (wasm: ${wasmJsPath})`);
+          } catch (e: any) {
+            api.logger.warn(`sulcus: WASM load failed: ${e.message}`);
+          }
+        } else {
+          api.logger.warn(`sulcus: WASM module not found at ${wasmJsPath}`);
         }
       } else {
-        api.logger.info(`sulcus: no cloud fallback — serverUrl: ${serverUrl ? "set" : "missing"}, apiKey: ${apiKey ? "set" : "missing"}`);
+        api.logger.info(`sulcus: local mode skipped — ${nativeLoader.error || "dylibs not found"}`);
       }
     }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@digitalforgestudios/openclaw-sulcus",
-  "version": "3.5.2",
+  "version": "3.5.4",
   "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",