@digitalforgestudios/openclaw-sulcus 0.1.0 → 0.1.2

package/index.ts

@@ -204,7 +204,9 @@ const sulcusMemoryPlugin = {
       serverUrl: (rawCfg as any).serverUrl ?? "https://api.sulcus.ca",
       apiKey: (rawCfg as any).apiKey ?? "",
       agentId: (rawCfg as any).agentId,
-      namespace: (rawCfg as any).namespace ?? (rawCfg as any).agentId,
+      namespace: ((rawCfg as any).namespace && (rawCfg as any).namespace !== "default")
+        ? (rawCfg as any).namespace
+        : ((rawCfg as any).agentId ?? "default"),
       autoRecall: (rawCfg as any).autoRecall ?? true,
       autoCapture: (rawCfg as any).autoCapture ?? true,
       maxRecallResults: (rawCfg as any).maxRecallResults ?? 5,
@@ -446,6 +448,42 @@ const sulcusMemoryPlugin = {
       { name: "memory_forget" },
     );
 
+    // ========================================================================
+    // Lifecycle — System prompt preamble (LLM awareness)
+    // ========================================================================
+
+    const sulcusPreamble = [
+      "## Persistent Memory (Sulcus)",
+      "You have persistent memory powered by Sulcus. Your memories survive across sessions and conversations.",
+      "",
+      "**How it works:**",
+      "- Memories are automatically recalled and injected into your context when relevant.",
+      "- Each memory has a **heat** score (0.0–1.0) — hotter memories are more recent/important, cold ones fade over time.",
+      "- Memory types: episodic (events), semantic (facts), preference (opinions), procedural (how-tos), fact (data points).",
+      "",
+      "**Your memory tools:**",
+      "- `memory_search` — find memories by semantic query. Use before answering about past work, decisions, or preferences.",
+      "- `memory_store` — save important information. Use for preferences, key decisions, facts worth remembering, lessons learned.",
+      "- `memory_get` — retrieve a specific memory by ID.",
+      "- `memory_forget` — delete a memory that's outdated or wrong.",
+      "",
+      "**When to store memories:**",
+      "- User states a preference, opinion, or personal fact",
+      "- An important decision is made",
+      "- You learn something that should survive this session",
+      "- A correction is given (store the correct version, forget the wrong one)",
+      "",
+      "**When to search memories:**",
+      "- Before answering questions about prior work, people, or decisions",
+      "- When context seems incomplete — there may be relevant history",
+      "- When the user references something from a previous conversation",
+    ].join("\n");
+
+    // Inject preamble into system prompt via before_prompt_build hook
+    api.on("before_prompt_build", () => {
+      return { appendSystemContext: sulcusPreamble };
+    });
+
     // ========================================================================
     // Lifecycle — Auto-recall
     // ========================================================================

package/package.json

@@ -1,8 +1,16 @@
 {
   "name": "@digitalforgestudios/openclaw-sulcus",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "description": "Sulcus thermodynamic memory backend plugin for OpenClaw. Heat-based decay, cross-agent sync, programmable triggers, auto-recall, and auto-capture.",
-  "keywords": ["openclaw", "plugin", "memory", "sulcus", "thermodynamic", "ai-agent", "long-term-memory"],
+  "keywords": [
+    "openclaw",
+    "plugin",
+    "memory",
+    "sulcus",
+    "thermodynamic",
+    "ai-agent",
+    "long-term-memory"
+  ],
   "author": "Digital Forge <daedalus@tc-o.co>",
   "license": "MIT",
   "repository": {
@@ -12,7 +20,9 @@
   },
   "homepage": "https://sulcus.ca/docs#openclaw",
   "openclaw": {
-    "extensions": ["./index.ts"]
+    "extensions": [
+      "./index.ts"
+    ]
   },
   "files": [
     "index.ts",