@badgerclaw/connect 1.3.2 → 1.3.3

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@badgerclaw/connect",
-  "version": "1.3.2",
+  "version": "1.3.3",
   "description": "BadgerClaw channel plugin for OpenClaw",
   "type": "module",
   "dependencies": {
@@ -31,4 +31,4 @@
       "defaultChoice": "npm"
     }
   }
-}
+}

package/src/matrix/monitor/auto-join.ts

@@ -3,6 +3,7 @@ import type { RuntimeEnv } from "openclaw/plugin-sdk/matrix";
 import { getMatrixRuntime } from "../../runtime.js";
 import type { CoreConfig } from "../../types.js";
 import { loadMatrixSdk } from "../sdk-runtime.js";
+import { initRoomHistory } from "./chat-history.js";
 
 // Track clients that already have auto-join registered to prevent duplicate listeners
 const autoJoinRegistered = new WeakSet<object>();
@@ -73,6 +74,9 @@ export function registerMatrixAutoJoin(params: {
     // AutojoinRoomsMixin handles the join, so listen for room.join to run post-join logic
     client.on("room.join", async (roomId: string, _joinEvent: unknown) => {
       logVerbose(`badgerclaw: bot joined room ${roomId} (always mode), running post-join handshake`);
+      if (cfg.chatHistory?.enabled) {
+        initRoomHistory(roomId);
+      }
       await postJoinEncryptionHandshake(roomId);
     });
     return;
@@ -111,6 +115,9 @@ export function registerMatrixAutoJoin(params: {
     try {
       await client.joinRoom(roomId);
       logVerbose(`badgerclaw: joined room ${roomId}`);
+      if (cfg.chatHistory?.enabled) {
+        initRoomHistory(roomId);
+      }
       await postJoinEncryptionHandshake(roomId);
     } catch (err) {
       runtime.error?.(`badgerclaw: failed to join room ${roomId}: ${String(err)}`);

package/src/matrix/monitor/chat-history.ts

@@ -0,0 +1,75 @@
+import fs from "fs";
+import path from "path";
+import os from "os";
+
+const HISTORY_DIR = path.join(os.homedir(), ".openclaw", "extensions", "badgerclaw", "history");
+const MAX_MESSAGES = 200;
+
+export interface HistoryEntry {
+  ts: string;       // ISO timestamp
+  sender: string;   // display name or username
+  text: string;     // message text
+  role: "user" | "bot";
+}
+
+export function getHistoryPath(roomId: string): string {
+  // Sanitize roomId for filename: replace ! and : with safe chars
+  const safe = roomId.replace(/[!:]/g, "_").replace(/\./g, "-");
+  return path.join(HISTORY_DIR, `${safe}.md`);
+}
+
+export function ensureHistoryDir(): void {
+  if (!fs.existsSync(HISTORY_DIR)) {
+    fs.mkdirSync(HISTORY_DIR, { recursive: true });
+  }
+}
+
+export function readHistory(roomId: string): HistoryEntry[] {
+  const filePath = getHistoryPath(roomId);
+  if (!fs.existsSync(filePath)) return [];
+  try {
+    const content = fs.readFileSync(filePath, "utf8");
+    const lines = content.split("\n").filter((l: string) => l.startsWith("["));
+    return lines.map((line: string) => {
+      // Format: [2026-03-27T08:05:00Z] [user] sender: text
+      const match = line.match(/^\[([^\]]+)\] \[(user|bot)\] ([^:]+): (.+)$/);
+      if (!match) return null;
+      return { ts: match[1], role: match[2] as "user" | "bot", sender: match[3], text: match[4] };
+    }).filter(Boolean) as HistoryEntry[];
+  } catch {
+    return [];
+  }
+}
+
+export function appendHistory(roomId: string, entry: HistoryEntry, roomName?: string): void {
+  ensureHistoryDir();
+  const filePath = getHistoryPath(roomId);
+
+  // Read existing, append, trim to 200
+  let entries = readHistory(roomId);
+  entries.push(entry);
+  if (entries.length > MAX_MESSAGES) {
+    entries = entries.slice(entries.length - MAX_MESSAGES);
+  }
+
+  // Write header + entries
+  const header = `# Chat History — ${roomId}\n# Group: ${roomName || roomId} | Updated: ${new Date().toISOString()}\n# Last ${MAX_MESSAGES} messages (rolling)\n\n`;
+  const body = entries.map(e => `[${e.ts}] [${e.role}] ${e.sender}: ${e.text}`).join("\n");
+  fs.writeFileSync(filePath, header + body + "\n", "utf8");
+}
+
+export function formatHistoryForContext(roomId: string): string | null {
+  const entries = readHistory(roomId);
+  if (entries.length === 0) return null;
+  const lines = entries.map(e => `${e.sender}: ${e.text}`).join("\n");
+  return `## Recent conversation history (last ${entries.length} messages):\n${lines}\n\n---\n`;
+}
+
+export function initRoomHistory(roomId: string, roomName?: string): void {
+  ensureHistoryDir();
+  const filePath = getHistoryPath(roomId);
+  if (!fs.existsSync(filePath)) {
+    const header = `# Chat History — ${roomId}\n# Group: ${roomName || roomId} | Created: ${new Date().toISOString()}\n# Last ${MAX_MESSAGES} messages (rolling)\n\n`;
+    fs.writeFileSync(filePath, header, "utf8");
+  }
+}

package/src/matrix/monitor/handler.ts

@@ -30,6 +30,7 @@ import {
   resolveMatrixAllowListMatch,
   resolveMatrixAllowListMatches,
 } from "./allowlist.js";
+import { appendHistory, formatHistoryForContext } from "./chat-history.js";
 import {
   resolveMatrixBodyForAgent,
   resolveMatrixInboundSenderLabel,
@@ -630,13 +631,33 @@ export function createMatrixRoomMessageHandler(params: MatrixMonitorHandlerParam
       });
 
       const groupSystemPrompt = roomConfig?.systemPrompt?.trim() || undefined;
+
+      // Append inbound user message to chat history
+      if (cfg.chatHistory?.enabled) {
+        appendHistory(roomId, {
+          ts: new Date().toISOString(),
+          role: "user",
+          sender: senderName || senderId,
+          text: bodyText,
+        }, roomName);
+      }
+
+      // Inject rolling history into BodyForAgent context
+      let bodyForAgent = resolveMatrixBodyForAgent({
+        isDirectMessage,
+        bodyText,
+        senderLabel,
+      });
+      if (cfg.chatHistory?.enabled) {
+        const history = formatHistoryForContext(roomId);
+        if (history) {
+          bodyForAgent = history + bodyForAgent;
+        }
+      }
+
       const ctxPayload = core.channel.reply.finalizeInboundContext({
         Body: body,
-        BodyForAgent: resolveMatrixBodyForAgent({
-          isDirectMessage,
-          bodyText,
-          senderLabel,
-        }),
+        BodyForAgent: bodyForAgent,
         RawBody: bodyText,
         CommandBody: bodyText,
         From: isDirectMessage ? `badgerclaw:${senderId}` : `badgerclaw:channel:${roomId}`,
@@ -775,6 +796,15 @@ export function createMatrixRoomMessageHandler(params: MatrixMonitorHandlerParam
               accountId: route.accountId,
               tableMode,
             });
+            if (cfg.chatHistory?.enabled && payload?.text) {
+              const botSender = resolveMatrixSenderUsername(selfUserId) || selfUserId;
+              appendHistory(roomId, {
+                ts: new Date().toISOString(),
+                role: "bot",
+                sender: botSender,
+                text: payload.text,
+              }, roomName);
+            }
             didSendReply = true;
           },
           onError: (err, info) => {

package/src/types.ts

@@ -114,5 +114,8 @@ export type CoreConfig = {
     ackReaction?: string;
     ackReactionScope?: "group-mentions" | "group-all" | "direct" | "all" | "off" | "none";
   };
+  chatHistory?: {
+    enabled: boolean;
+  };
   [key: string]: unknown;
 };