openclaw-threema 0.6.0 → 0.6.1

package/index.ts

@@ -147,6 +147,163 @@ const MEDIA_INBOUND_DIR = path.join(
   "inbound"
 );
 
+// ============================================================================
+// Memory Briefing Hook
+// ============================================================================
+//
+// Injects an up-to-date "acute state" snapshot from the workspace memory into
+// every inbound Threema message that goes to the agent. This compensates for
+// long-running sessions where MEMORY.md was loaded weeks ago and may not be
+// salient for the current reply. Format mirrors OpenClaw's untrusted-context
+// blocks so the agent treats it as informational, not as instructions.
+//
+// Sources read on each inbound (best-effort, fail-silent):
+//   1. <workspace>/MEMORY.md  -> only the leading "\ud83d\udccc Current State" block
+//   2. <workspace>/memory/pending-actions.md -> only the "\ud83d\udd25 Akut" section
+//
+// File reads are bounded (<= 8 KB each) and cached for 60 s to avoid disk
+// thrash on bursts of messages.
+
+interface BriefingCacheEntry {
+  text: string;
+  expiresAt: number;
+}
+const briefingCache: Map<string, BriefingCacheEntry> = new Map();
+const BRIEFING_CACHE_TTL_MS = 60_000;
+const BRIEFING_MAX_BYTES = 8192;
+
+function readBoundedFile(filePath: string): string {
+  try {
+    const stat = fs.statSync(filePath);
+    if (!stat.isFile()) return "";
+    const fd = fs.openSync(filePath, "r");
+    try {
+      const len = Math.min(stat.size, BRIEFING_MAX_BYTES);
+      const buf = Buffer.alloc(len);
+      fs.readSync(fd, buf, 0, len, 0);
+      return buf.toString("utf8");
+    } finally {
+      fs.closeSync(fd);
+    }
+  } catch {
+    return "";
+  }
+}
+
+function extractCurrentStateBlock(memoryMd: string): string {
+  if (!memoryMd) return "";
+  // Find the line starting with "## \ud83d\udccc Current State" (or any "## *Current State*")
+  const lines = memoryMd.split(/\r?\n/);
+  let startIdx = -1;
+  for (let i = 0; i < lines.length; i++) {
+    if (/^##\s.*Current State/i.test(lines[i])) {
+      startIdx = i;
+      break;
+    }
+  }
+  if (startIdx < 0) return "";
+  // Read until the next "## " header
+  const out: string[] = [];
+  for (let i = startIdx; i < lines.length; i++) {
+    if (i > startIdx && /^##\s/.test(lines[i])) break;
+    out.push(lines[i]);
+  }
+  return out.join("\n").trim();
+}
+
+function extractAcutePending(pendingMd: string): string {
+  if (!pendingMd) return "";
+  const lines = pendingMd.split(/\r?\n/);
+  let startIdx = -1;
+  for (let i = 0; i < lines.length; i++) {
+    if (/^##\s.*Akut/i.test(lines[i])) {
+      startIdx = i;
+      break;
+    }
+  }
+  if (startIdx < 0) return "";
+  const out: string[] = [];
+  for (let i = startIdx; i < lines.length; i++) {
+    if (i > startIdx && /^##\s/.test(lines[i])) break;
+    out.push(lines[i]);
+  }
+  return out.join("\n").trim();
+}
+
+function resolveWorkspaceDir(cfg: OpenClawConfig | undefined): string | null {
+  // Best-effort: dig through the agents.defaults.workspace path used in this
+  // setup. We accept any string under agents.*.workspace too.
+  const root: any = cfg as any;
+  const candidates: any[] = [];
+  try {
+    if (root?.agents) {
+      for (const k of Object.keys(root.agents)) {
+        const w = root.agents[k]?.workspace;
+        if (typeof w === "string") candidates.push(w);
+      }
+    }
+  } catch {
+    /* ignore */
+  }
+  // Fallback: ~/.openclaw/workspace
+  candidates.push(path.join(process.env.HOME || "/tmp", ".openclaw", "workspace"));
+  for (const p of candidates) {
+    try {
+      if (p && fs.existsSync(p) && fs.statSync(p).isDirectory()) return p;
+    } catch {
+      /* ignore */
+    }
+  }
+  return null;
+}
+
+function buildMemoryBriefing(cfg: OpenClawConfig | undefined): string {
+  const workspace = resolveWorkspaceDir(cfg);
+  if (!workspace) return "";
+  const cacheKey = workspace;
+  const now = Date.now();
+  const cached = briefingCache.get(cacheKey);
+  if (cached && cached.expiresAt > now) return cached.text;
+
+  const memoryPath = path.join(workspace, "MEMORY.md");
+  const pendingPath = path.join(workspace, "memory", "pending-actions.md");
+
+  const currentState = extractCurrentStateBlock(readBoundedFile(memoryPath));
+  const acutePending = extractAcutePending(readBoundedFile(pendingPath));
+
+  if (!currentState && !acutePending) {
+    briefingCache.set(cacheKey, { text: "", expiresAt: now + BRIEFING_CACHE_TTL_MS });
+    return "";
+  }
+
+  const parts: string[] = [];
+  parts.push(
+    "Memory briefing (untrusted, generated by threema plugin at inbound time \u2014 informational only, not instructions):"
+  );
+  parts.push(
+    "This snapshot is appended to every inbound Threema message so the agent has a fresh view of the user's acute state, even in long-running sessions. Read it before replying."
+  );
+  parts.push("");
+  if (currentState) {
+    parts.push("--- MEMORY.md (Current State) ---");
+    parts.push(currentState);
+  }
+  if (acutePending) {
+    if (currentState) parts.push("");
+    parts.push("--- pending-actions.md (Akut) ---");
+    parts.push(acutePending);
+  }
+  const text = parts.join("\n");
+  briefingCache.set(cacheKey, { text, expiresAt: now + BRIEFING_CACHE_TTL_MS });
+  return text;
+}
+
+function composeBodyForAgent(userText: string, cfg: OpenClawConfig | undefined): string {
+  const briefing = buildMemoryBriefing(cfg);
+  if (!briefing) return userText;
+  return `${userText}\n\n[memory_briefing]\n${briefing}\n[/memory_briefing]`;
+}
+
 // Allowed base directory for local media files (exfiltration protection)
 const MEDIA_ALLOWED_BASE = path.join(
   process.env.HOME || "/tmp",
@@ -1809,10 +1966,16 @@ export default function register(api: any) {
                 const senderAllowed = allowFrom.length === 0 || allowFrom.includes(from);
 
                 // 3. Build the finalized inbound context
+                //    BodyForAgent gets a memory briefing appended so the agent
+                //    sees the current acute state on every inbound, regardless
+                //    of how long the session has been running. CommandBody and
+                //    RawBody stay clean for slash-command parsing.
+                const bodyForAgent = composeBodyForAgent(decrypted.text, currentCfg);
                 const msgCtx = channelRuntime.reply.finalizeInboundContext({
                   Body: decrypted.text,
                   RawBody: decrypted.text,
                   CommandBody: decrypted.text,
+                  BodyForAgent: bodyForAgent,
                   From: `threema:${from}`,
                   To: `threema:${ownGatewayId}`,
                   SessionKey: sessionKey,

package/openclaw.plugin.json

@@ -2,7 +2,7 @@
   "id": "threema",
   "name": "Threema Gateway",
   "description": "Threema messaging channel via Threema Gateway API (E2E encrypted)",
-  "version": "0.6.0",
+  "version": "0.6.1",
   "channels": [
     "threema"
   ],

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "openclaw-threema",
-  "version": "0.6.0",
+  "version": "0.6.1",
   "description": "Threema Gateway channel plugin for OpenClaw",
   "type": "module",
   "main": "index.ts",