@digitalforgestudios/openclaw-sulcus 3.12.0 → 4.2.0

package/openclaw.plugin.json

@@ -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.12.0",
-  "description": "Sulcus — thermodynamic memory + Apache AGE knowledge graph for OpenClaw agents. SIU v2 pipeline auto-classifies and scores memories. Interaction-based decay (3 modes). Curator sleep-cycle. Relevance-weighted recall. Cross-agent sync.",
+  "version": "4.2.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",