@digitalforgestudios/openclaw-sulcus 3.11.1 → 4.0.0

package/openclaw.plugin.json

@@ -2,7 +2,7 @@
   "id": "openclaw-sulcus",
   "kind": "memory",
   "name": "Sulcus",
-  "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.",
+  "description": "Thermodynamic memory + Apache AGE knowledge graph for AI agents. SIU v2 pipeline (SIVU/SICU/SILU/SITU) auto-classifies and scores every memory. Interaction-based decay (Time-only, Interaction-only, Hybrid). Curator sleep-cycle reclassifies and consolidates. Relevance-weighted recall (similarity × 0.7 + heat × 0.3). Confidence levels and conflict detection (v2.3.0). 52 API routes, 32 server modules. Runs locally via WASM + native dylibs; optional cloud sync via serverUrl/apiKey.",
   "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.",
@@ -51,19 +51,24 @@
       },
       "autoRecall": {
         "type": "boolean",
-        "description": "Inject relevant memories before agent starts. Disabled by default — enable explicitly to opt in.",
+        "description": "Inject relevant memories before agent starts (prependContext SDK path). Disabled by default — enable explicitly to opt in.",
         "default": false
       },
       "autoCapture": {
         "type": "boolean",
-        "description": "Auto-capture memories from conversations. Disabled by default — enable explicitly to opt in.",
+        "description": "Auto-capture memories from conversations via SIVU quality gate. Disabled by default — enable explicitly to opt in.",
         "default": false
       },
       "maxRecallResults": {
         "type": "number",
-        "description": "Max memories to inject on auto-recall",
+        "description": "Maximum memories injected into context per turn (1-20)",
         "default": 5
       },
+      "profileFrequency": {
+        "type": "number",
+        "description": "Inject full user profile (preferences + facts) every N turns (1-500)",
+        "default": 10
+      },
       "minRecallScore": {
         "type": "number",
         "description": "Min relevance score for auto-recall (0-1)",
@@ -120,23 +125,83 @@
     }
   },
   "uiHints": {
-    "serverUrl": { "label": "Server URL", "placeholder": "https://api.sulcus.ca" },
-    "apiKey": { "label": "API Key", "sensitive": true, "placeholder": "sk-..." },
-    "agentId": { "label": "Agent ID", "placeholder": "daedalus" },
-    "namespace": { "label": "Namespace", "placeholder": "daedalus" },
-    "autoRecall": { "label": "Auto-Recall (disabled by default)" },
-    "autoCapture": { "label": "Auto-Capture (disabled by default)" },
-    "maxRecallResults": { "label": "Max Recall Results" },
-    "minRecallScore": { "label": "Min Recall Score" },
-    "captureFromAssistant": { "label": "Capture from Assistant Messages" },
-    "captureOnCompaction": { "label": "Preserve Memories on Compaction" },
-    "captureOnReset": { "label": "Capture Summary on Session Reset" },
-    "trackSessions": { "label": "Track Session Start/End" },
-    "boostOnRecall": { "label": "Boost Heat on Recall (Spaced Repetition)" },
-    "captureToolResults": { "label": "Capture Tool Results" },
-    "captureLlmInsights": { "label": "Capture LLM Insights" },
-    "captureToolResults": { "label": "Capture Tool Results" },
-    "captureLlmInsights": { "label": "Capture LLM Insights" },
-    "maxCapturePerTurn": { "label": "Max Auto-Capture per Turn" }
+    "serverUrl": {
+      "label": "Sulcus Server URL",
+      "placeholder": "https://api.sulcus.ca",
+      "help": "Your Sulcus server URL. Leave empty for local-only mode."
+    },
+    "apiKey": {
+      "label": "API Key",
+      "sensitive": true,
+      "placeholder": "sk-...",
+      "help": "Your Sulcus API key (from sulcus.ca dashboard)"
+    },
+    "agentId": {
+      "label": "Agent ID",
+      "placeholder": "icarus",
+      "help": "Agent identifier for memory namespacing"
+    },
+    "namespace": {
+      "label": "Namespace",
+      "placeholder": "icarus",
+      "help": "Memory namespace (defaults to agentId)"
+    },
+    "autoRecall": {
+      "label": "Auto-Recall",
+      "help": "Inject relevant memories before every AI turn (uses prependContext SDK path)"
+    },
+    "autoCapture": {
+      "label": "Auto-Capture",
+      "help": "Automatically store important information from conversations (quality-gated by SIVU)"
+    },
+    "maxRecallResults": {
+      "label": "Max Recall Results",
+      "placeholder": "5",
+      "help": "Maximum memories injected into context per turn",
+      "advanced": true
+    },
+    "profileFrequency": {
+      "label": "Profile Injection Frequency",
+      "placeholder": "10",
+      "help": "Inject full user profile (preferences + facts) every N turns",
+      "advanced": true
+    },
+    "minRecallScore": {
+      "label": "Min Recall Score",
+      "advanced": true,
+      "help": "Minimum relevance score for auto-recall (0.0–1.0)"
+    },
+    "captureFromAssistant": {
+      "label": "Capture from Assistant Messages",
+      "advanced": true
+    },
+    "captureOnCompaction": {
+      "label": "Preserve Memories on Compaction",
+      "advanced": true
+    },
+    "captureOnReset": {
+      "label": "Capture Summary on Session Reset",
+      "advanced": true
+    },
+    "trackSessions": {
+      "label": "Track Session Start/End",
+      "advanced": true
+    },
+    "boostOnRecall": {
+      "label": "Boost Heat on Recall (Spaced Repetition)",
+      "advanced": true
+    },
+    "captureToolResults": {
+      "label": "Capture Tool Results",
+      "advanced": true
+    },
+    "captureLlmInsights": {
+      "label": "Capture LLM Insights",
+      "advanced": true
+    },
+    "maxCapturePerTurn": {
+      "label": "Max Auto-Capture per Turn",
+      "advanced": true
+    }
   }
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@digitalforgestudios/openclaw-sulcus",
-  "version": "3.11.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.",
+  "version": "4.0.0",
+  "description": "Sulcus — thermodynamic memory + Apache AGE knowledge graph for OpenClaw agents. v4: registerMemoryRuntime, prependContext recall, registerMemoryPromptSection, registerService lifecycle, uiHints, provider-filtered auto-capture. SIU v2 pipeline auto-classifies and scores memories. Interaction-based decay (3 modes). Curator sleep-cycle. Relevance-weighted recall. Cross-agent sync.",
   "keywords": [
     "openclaw",
     "openclaw-plugin",
@@ -9,11 +9,16 @@
     "memory",
     "sulcus",
     "thermodynamic",
+    "knowledge-graph",
+    "age-graph",
+    "siu-pipeline",
     "ai-agent",
     "ai-memory",
     "long-term-memory",
     "heat-decay",
-    "cross-agent"
+    "cross-agent",
+    "curator",
+    "interaction-decay"
   ],
   "author": "Digital Forge Studios <contact@dforge.ca>",
   "license": "MIT",