@mingxy/cerebro 1.5.10 → 1.6.1

package/package.json

@@ -1,11 +1,12 @@
 {
   "name": "@mingxy/cerebro",
-  "version": "1.5.10",
+  "version": "1.6.1",
   "description": "Cerebro persistent memory plugin for OpenCode — auto-recall, auto-capture, 9 memory tools with clustering",
   "type": "module",
   "main": "src/index.ts",
   "oc-plugin": [
-    "server"
+    "server",
+    "tui"
   ],
   "keywords": [
     "opencode",

package/src/client.ts

@@ -359,4 +359,16 @@ export class OmemClient {
     );
     return res?.recalls ?? [];
   }
+
+  async sessionIngest(
+    messages: Array<{ role: string; content: string }>,
+    sessionId?: string,
+    agentId?: string,
+  ): Promise<unknown> {
+    return this.post("/v1/memories/session-ingest", {
+      messages,
+      session_id: sessionId,
+      agent_id: agentId,
+    }, 60000);
+  }
 }

package/src/hooks.ts

@@ -12,31 +12,17 @@ function showToast(tui: any, title: string, message: string, variant: string = "
   }, delayMs);
 }
 
+function extractUserRequest(content: string): string {
+  const match = content.match(/<user-request>([\s\S]*?)<\/user-request>/);
+  return match ? match[1].trim() : content;
+}
+
 const keywordDetectedSessions = new Set<string>();
 const injectedMemoryIds = new Map<string, Set<string>>();
 const firstMessages = new Map<string, string>();
 const sessionMessages = new Map<string, Array<{ role: string; content: string }>>();
 const profileInjectedSessions = new Set<string>();
 
-function extractMemoryIds(result: unknown): string[] {
-  if (!result) return [];
-  if (Array.isArray(result)) {
-    return (result as Array<{ id?: string }>).map((m) => m.id).filter(Boolean) as string[];
-  }
-  if (typeof result === "object" && result !== null) {
-    const r = result as Record<string, unknown>;
-    if (Array.isArray(r.memories)) {
-      return (r.memories as Array<{ id?: string }>).map((m) => m.id).filter(Boolean) as string[];
-    }
-    if (Array.isArray(r.results)) {
-      return (r.results as Array<{ id?: string; memory?: { id?: string } }>)
-        .map((m) => m.id ?? m.memory?.id)
-        .filter(Boolean) as string[];
-    }
-  }
-  return [];
-}
-
 function formatRelativeAge(isoDate: string): string {
   const diffMs = Date.now() - new Date(isoDate).getTime();
   const minutes = Math.floor(diffMs / 60_000);
@@ -149,14 +135,15 @@ export function autoRecallHook(client: OmemClient, containerTags: string[], tui:
     try {
       const messages = sessionMessages.get(input.sessionID) ?? [];
       const userMessages = messages.filter((m) => m.role === "user");
-      const query_text = userMessages[userMessages.length - 1]?.content || firstMessages.get(input.sessionID) || "";
+      const rawQuery = userMessages[userMessages.length - 1]?.content || firstMessages.get(input.sessionID) || "";
+      const query_text = extractUserRequest(rawQuery);
       const last_query_text = userMessages.length >= 2 ? userMessages[userMessages.length - 2].content : undefined;
 
       const projectTags = containerTags.filter(t => t.startsWith("omem_project_"));
       const shouldRecallRes = await client.shouldRecall(query_text, last_query_text, input.sessionID, similarityThreshold, maxRecallResults, projectTags.length > 0 ? projectTags : undefined);
 
       if (!shouldRecallRes) {
-        showToast(tui, "🧠 Omem Service Unavailable", "Unable to reach memory API · check connection", "error", toastDelayMs);
+        showToast(tui, "🧠 Cerebro Service Unavailable", "Unable to reach memory API · check connection", "error", toastDelayMs);
         return;
       }
 
@@ -263,14 +250,14 @@ export function autoRecallHook(client: OmemClient, containerTags: string[], tui:
         // Server returned error (500, etc.) with details
         const cleanMsg = errMsg.replace(/^\[omem\]\s*/, "");
         if (cleanMsg.startsWith("500")) {
-          showToast(tui, "🧠 Omem Server Error", cleanMsg.substring(0, 200), "error");
+          showToast(tui, "🧠 Cerebro Server Error", cleanMsg.substring(0, 200), "error");
         } else if (cleanMsg.includes("timed out")) {
-          showToast(tui, "🧠 Omem Service Timeout", cleanMsg.substring(0, 100), "error");
+          showToast(tui, "🧠 Cerebro Service Timeout", cleanMsg.substring(0, 100), "error");
         } else {
-          showToast(tui, "🧠 Omem Error", cleanMsg.substring(0, 150), "error");
+          showToast(tui, "🧠 Cerebro Error", cleanMsg.substring(0, 150), "error");
         }
       } else if (errMsg.includes("fetch") || errMsg.includes("network")) {
-        showToast(tui, "🧠 Omem Service Unavailable", "Network error · check API connection", "error");
+        showToast(tui, "🧠 Cerebro Service Unavailable", "Network error · check API connection", "error");
       } else {
         showToast(tui, "🧠 Memory Recall Error", errMsg.substring(0, 100), "error");
       }
@@ -278,7 +265,7 @@ export function autoRecallHook(client: OmemClient, containerTags: string[], tui:
   };
 }
 
-export function keywordDetectionHook(client: OmemClient, containerTags: string[], threshold: number, tui: any, ingestMode: "smart" | "raw" = "smart") {
+export function keywordDetectionHook(_client: OmemClient, _containerTags: string[], threshold: number, _tui: any, _ingestMode: "smart" | "raw" = "smart") {
   return async (
     input: { sessionID: string; messageID?: string },
     output: { message: UserMessage; parts: Part[] },
@@ -307,65 +294,41 @@ export function keywordDetectionHook(client: OmemClient, containerTags: string[]
     });
 
     const messages = sessionMessages.get(input.sessionID)!;
+    // Ingest is now handled by sessionIdleHook (session.idle → sessionIngest API).
+    // This hook only collects messages and detects keywords for recall.
     if (messages.length >= threshold) {
-      try {
-        const result = await client.ingestMessages(messages, {
-          mode: ingestMode,
-          tags: [...containerTags, "auto-capture"],
-          sessionId: input.sessionID,
-        });
-        if (result === null) {
-          showToast(tui, "🔴 Capture Failed", `Memory capture blocked · check API Key and spiritual connection`, "error");
-        } else {
-          showToast(tui, "🧠 Memory Sealed", `${messages.length} dialogues captured · entrusted to the heavens for refinement`, "success");
-          const memoryIds = extractMemoryIds(result);
-          if (memoryIds.length > 0) {
-            const recordResult = await client.recordSessionRecall(
-              input.sessionID,
-              memoryIds,
-              "auto",
-              firstMessages.get(input.sessionID) || "",
-              0,
-              0,
-            );
-            if (recordResult) {
-              showToast(tui, "📦 Capture Recorded", `${memoryIds.length} memory(s) saved to session history`, "success");
-            } else {
-              showToast(tui, "🔴 Capture Record Failed", `Failed to save capture record · check API connection`, "error");
-            }
-          }
-          sessionMessages.delete(input.sessionID);
-        }
-      } catch {
-        showToast(tui, "🔴 Capture Failed", "Memory capture blocked · spiritual pulse anomaly", "error");
-      }
+      // Threshold reached — messages will be processed on next session.idle
     }
   };
 }
 
-export function compactingHook(client: OmemClient, containerTags: string[], tui: any, ingestMode: "smart" | "raw" = "smart") {
+export function compactingHook(client: OmemClient, containerTags: string[], tui: any, ingestMode: "smart" | "raw" = "smart", isAutoStoreEnabled?: (sessionId: string | undefined) => boolean) {
   return async (
     input: { sessionID?: string },
     output: { context: string[]; prompt?: string },
   ) => {
     if (input.sessionID && sessionMessages.has(input.sessionID)) {
-      const messages = sessionMessages.get(input.sessionID)!;
-      if (messages.length > 0) {
-        try {
-          const result = await client.ingestMessages(messages, {
-            mode: ingestMode,
-            tags: [...containerTags, "auto-capture"],
-            sessionId: input.sessionID,
-          });
-          if (result === null) {
-            showToast(tui, "🔴 Archive Failed", "Session archive blocked · check spiritual realm status", "error");
-          } else {
-            showToast(tui, "📦 Session Archived", `${messages.length} residual dialogues archived · merged into the realm`, "success");
+      if (isAutoStoreEnabled && !isAutoStoreEnabled(input.sessionID)) {
+        sessionMessages.delete(input.sessionID);
+      } else {
+        const messages = sessionMessages.get(input.sessionID)!;
+        if (messages.length > 0) {
+          try {
+            const result = await client.ingestMessages(messages, {
+              mode: ingestMode,
+              tags: [...containerTags, "auto-capture"],
+              sessionId: input.sessionID,
+            });
+            if (result === null) {
+              showToast(tui, "🔴 Archive Failed", "Session archive blocked · check spiritual realm status", "error");
+            } else {
+              showToast(tui, "📦 Session Archived", `${messages.length} residual dialogues archived · merged into the realm`, "success");
+            }
+          } catch {
+            showToast(tui, "🔴 Archive Failed", "Session archive blocked · spiritual pulse anomaly", "error");
           }
-        } catch {
-          showToast(tui, "🔴 Archive Failed", "Session archive blocked · spiritual pulse anomaly", "error");
+          sessionMessages.delete(input.sessionID);
         }
-        sessionMessages.delete(input.sessionID);
       }
     }
 
@@ -379,3 +342,97 @@ export function compactingHook(client: OmemClient, containerTags: string[], tui:
     }
   };
 }
+
+const processedMessageIds = new Set<string>();
+const pluginStartTime = Date.now();
+
+export function sessionIdleHook(
+  omemClient: OmemClient,
+  _containerTags: string[],
+  tui: any,
+  sdkClient: any,
+  _ingestMode: "smart" | "raw" = "smart",
+  threshold: number = 0,
+  getMainSessionId?: () => string | undefined,
+  isAutoStoreEnabled?: (sessionId: string | undefined) => boolean,
+) {
+  let idleTimeout: ReturnType<typeof setTimeout> | null = null;
+  let isCapturing = false;
+
+  return async (input: { event: { type: string; properties?: any } }) => {
+    if (input.event.type !== "session.idle") return;
+
+    const sessionID = input.event.properties?.sessionID;
+    if (!sessionID) return;
+
+    if (isAutoStoreEnabled && !isAutoStoreEnabled(sessionID)) return;
+
+    if (getMainSessionId) {
+      const mainId = getMainSessionId();
+      if (mainId && sessionID !== mainId) return;
+    }
+
+    if (idleTimeout) clearTimeout(idleTimeout);
+
+    idleTimeout = setTimeout(async () => {
+      if (isCapturing) return;
+      isCapturing = true;
+
+      try {
+        const response = await sdkClient.session.messages({ path: { id: sessionID } });
+        if (!response?.data) return;
+
+        const messages = response.data;
+        const conversationMessages: Array<{ role: string; content: string }> = [];
+        const newMessageIds: string[] = [];
+        let hasNewMessages = false;
+
+        for (const msg of messages) {
+          const msgId = msg.info?.id;
+          if (!msgId || processedMessageIds.has(msgId)) continue;
+
+          // Skip messages created before this plugin instance started
+          // (prevents replaying entire session history on restart)
+          const msgTime = msg.info?.createdAt ? new Date(msg.info.createdAt).getTime() : 0;
+          if (msgTime > 0 && msgTime < pluginStartTime) continue;
+
+          const role = msg.info?.role;
+          if (role !== "user" && role !== "assistant") continue;
+
+          const textParts = (msg.parts || [])
+            .filter((p: any) => p.type === "text" && p.text)
+            .map((p: any) => p.text);
+          const text = textParts.join("\n").trim();
+          if (!text) continue;
+
+          hasNewMessages = true;
+          newMessageIds.push(msgId);
+          conversationMessages.push({ role, content: text });
+        }
+
+        if (!hasNewMessages || conversationMessages.length === 0) return;
+
+        if (threshold > 1 && conversationMessages.length < threshold) {
+          // Log that we're waiting for more messages
+          return;
+        }
+
+        try {
+          await omemClient.sessionIngest(conversationMessages, sessionID);
+          for (const id of newMessageIds) {
+            processedMessageIds.add(id);
+          }
+          showToast(tui, "🧠 Memory Sealed", `${conversationMessages.length} dialogues captured · entrusted to the heavens for refinement`, "success");
+        } catch (err) {
+          showToast(tui, "🔴 Session Capture Failed", String(err).substring(0, 100), "error");
+        }
+      } catch (err) {
+        const errMsg = err instanceof Error ? err.message : String(err);
+        showToast(tui, "🔴 Idle Capture Error", errMsg.substring(0, 100), "error");
+      } finally {
+        isCapturing = false;
+        idleTimeout = null;
+      }
+    }, 10000);
+  };
+}

package/src/index.ts

@@ -3,7 +3,7 @@ import { readFileSync } from "node:fs";
 import { join, dirname } from "node:path";
 import { fileURLToPath } from "node:url";
 import { OmemClient } from "./client.js";
-import { autoRecallHook, compactingHook, keywordDetectionHook } from "./hooks.js";
+import { autoRecallHook, compactingHook, keywordDetectionHook, sessionIdleHook } from "./hooks.js";
 import { getUserTag, getProjectTag } from "./tags.js";
 import { buildTools } from "./tools.js";
 import { logInfo, logError } from "./logger.js";
@@ -20,7 +20,22 @@ try {
   }
 } catch {}
 
-function showToast(tui: any, title: string, message: string, variant: string = "info", duration: number = 5000) {
+// Per-session auto-store toggle: sessionId → enabled (default: true = auto-store on)
+const autoStoreSessions = new Map<string, boolean>();
+
+export function isAutoStoreEnabled(sessionId: string | undefined): boolean {
+  if (!sessionId) return true;
+  return autoStoreSessions.get(sessionId) ?? true;
+}
+
+export function setAutoStoreEnabled(sessionId: string, enabled: boolean): void {
+  autoStoreSessions.set(sessionId, enabled);
+}
+
+// Bridge for TUI plugin (same process, different module graph)
+(globalThis as any).__cerebro_autoStore = isAutoStoreEnabled;
+
+function showToast(tui: any, title: string, message?: string, variant: string = "info", duration: number = 5000) {
   if (!tui) return;
   setTimeout(() => {
     try {
@@ -48,13 +63,7 @@ const OmemPlugin: Plugin = async (input) => {
   // 启动时检测连接状态
   try {
     await omemClient.getStats();
-    showToast(
-      tui,
-      `🧠 Omem v${pluginVersion} · Connected`,
-      `${config.apiUrl.replace(/^https?:\/\//, "")}`,
-      "success",
-      6000
-    );
+    showToast(tui, `🧠 Cerebro v${pluginVersion} · Connected`, undefined, "success", 6000);
     logInfo(`Connected to ${config.apiUrl}`);
   } catch (err) {
     const errMsg = err instanceof Error ? err.message : String(err);
@@ -63,7 +72,7 @@ const OmemPlugin: Plugin = async (input) => {
       const cleanMsg = errMsg.replace(/^\[omem\]\s*/, "");
       showToast(
         tui,
-        `🧠 Omem v${pluginVersion} · Server Error`,
+        `🧠 Cerebro v${pluginVersion} · Server Error`,
         cleanMsg.substring(0, 150),
         "error",
         8000
@@ -71,7 +80,7 @@ const OmemPlugin: Plugin = async (input) => {
     } else {
       showToast(
         tui,
-        `🧠 Omem v${pluginVersion} · Connection Failed`,
+        `🧠 Cerebro v${pluginVersion} · Connection Failed`,
         `Unable to reach ${config.apiUrl}`,
         "error",
         8000
@@ -89,13 +98,36 @@ const OmemPlugin: Plugin = async (input) => {
   const recallHook = autoRecallHook(omemClient, containerTags, tui, config);
 
   return {
+    config: async (cfg: any) => {
+      cfg.command ??= {};
+      cfg.command["memory-toggle"] = {
+        template: "/memory-toggle <on|off>",
+        description: "Toggle Cerebro auto-store ON or OFF for current session",
+      };
+    },
+    "command.execute.before": async (input: { command: string; sessionID: string; arguments: string }, output: { parts: any[] }) => {
+      if (input.command !== "memory-toggle") return;
+      const arg = input.arguments.trim().toLowerCase();
+      const sessionId = input.sessionID;
+      if (arg === "off") {
+        setAutoStoreEnabled(sessionId, false);
+        output.parts = [{ type: "text", text: "⏸️ Cerebro auto-store: OFF — manual memory_store still works" }];
+      } else if (arg === "on") {
+        setAutoStoreEnabled(sessionId, true);
+        output.parts = [{ type: "text", text: "✅ Cerebro auto-store: ON" }];
+      } else {
+        const current = isAutoStoreEnabled(sessionId);
+        output.parts = [{ type: "text", text: `Cerebro auto-store: ${current ? "✅ ON" : "⏸️ OFF"}\nUsage: /memory-toggle on | off` }];
+      }
+    },
     "experimental.chat.system.transform": async (input: any, output: any) => {
       if (input.sessionID) currentSessionId = input.sessionID;
       return recallHook(input, output);
     },
     "chat.message": keywordDetectionHook(omemClient, containerTags, config.autoCaptureThreshold, tui, config.ingestMode),
-    "experimental.session.compacting": compactingHook(omemClient, containerTags, tui, config.ingestMode),
+    "experimental.session.compacting": compactingHook(omemClient, containerTags, tui, config.ingestMode, isAutoStoreEnabled),
     tool: buildTools(omemClient, containerTags, { agentId, getSessionId: () => currentSessionId }),
+    event: sessionIdleHook(omemClient, containerTags, tui, client, config.ingestMode, config.autoCaptureThreshold, () => currentSessionId, isAutoStoreEnabled),
     "shell.env": async (_input: any, output: any) => {
       if (directory) {
         output.env.OMEM_PROJECT_DIR = directory;

package/src/tools.ts

@@ -1,5 +1,6 @@
 import { tool } from "@opencode-ai/plugin";
 import type { OmemClient } from "./client.js";
+import { isAutoStoreEnabled, setAutoStoreEnabled } from "./index.js";
 
 function extractMemoryIds(result: unknown): string[] {
   if (!result) return [];
@@ -373,5 +374,31 @@ export function buildTools(client: OmemClient, containerTags: string[], context:
         return JSON.stringify({ ok: true, result });
       },
     }),
+
+    memory_toggle: tool({
+      description:
+        "Toggle Cerebro auto-store ON or OFF for current session. Does NOT affect manual memory_store calls.",
+      args: {
+        state: tool.schema
+          .string()
+          .optional()
+          .describe("Set to 'on' or 'off'. Omit to check current status."),
+      },
+      async execute(args) {
+        const sessionId = context.getSessionId();
+        if (!sessionId) return JSON.stringify({ ok: false, error: "No active session" });
+
+        if (args.state === "on") {
+          setAutoStoreEnabled(sessionId, true);
+          return JSON.stringify({ ok: true, auto_store: true, message: "Cerebro auto-store: ON" });
+        } else if (args.state === "off") {
+          setAutoStoreEnabled(sessionId, false);
+          return JSON.stringify({ ok: true, auto_store: false, message: "Cerebro auto-store: OFF" });
+        } else {
+          const current = isAutoStoreEnabled(sessionId);
+          return JSON.stringify({ ok: true, auto_store: current, message: `Cerebro auto-store: ${current ? "ON" : "OFF"}` });
+        }
+      },
+    }),
   };
 }

package/src/tui.tsx

@@ -0,0 +1,72 @@
+// @ts-nocheck — TUI JSX is resolved at runtime by opencode (same as quota plugin)
+/** @jsxImportSource @opentui/solid */
+import type { TuiPlugin, TuiPluginApi, TuiPluginModule } from "@opencode-ai/plugin/tui";
+import { createEffect, createSignal, onCleanup } from "solid-js";
+
+const id = "@mingxy/cerebro";
+const SIDEBAR_ORDER = 160;
+
+function SidebarContentView(props: {
+  api: TuiPluginApi;
+  sessionID: string;
+}) {
+  const [autoStore, setAutoStore] = createSignal(true);
+
+  const unsubscribers = [
+    props.api.event.on("session.updated", () => {
+      setAutoStore(globalThis.__cerebro_autoStore?.(props.sessionID) ?? true);
+    }),
+    props.api.event.on("tui.session.select", (event) => {
+      if (event.properties?.sessionID === props.sessionID) {
+        setAutoStore(globalThis.__cerebro_autoStore?.(props.sessionID) ?? true);
+      }
+    }),
+  ];
+
+  createEffect(() => {
+    props.sessionID;
+    setAutoStore(globalThis.__cerebro_autoStore?.(props.sessionID) ?? true);
+  });
+
+  const interval = setInterval(() => {
+    setAutoStore(globalThis.__cerebro_autoStore?.(props.sessionID) ?? true);
+  }, 2000);
+
+  onCleanup(() => {
+    clearInterval(interval);
+    for (const unsubscribe of unsubscribers) unsubscribe();
+  });
+
+  const enabled = autoStore();
+
+  return (
+    <box gap={0}>
+      <text fg={props.api.theme.current.text}>
+        <b>Cerebro</b>
+      </text>
+      <box gap={0}>
+        <text fg={props.api.theme.current.text} wrapMode="none">
+          {enabled ? "✅ Auto-store: ON" : "⏸️  Auto-store: OFF"}
+        </text>
+      </box>
+    </box>
+  );
+}
+
+const tui: TuiPlugin = async (api) => {
+  api.slots.register({
+    order: SIDEBAR_ORDER,
+    slots: {
+      sidebar_content(_ctx, props: { session_id: string }) {
+        return <SidebarContentView api={api} sessionID={props.session_id} />;
+      },
+    },
+  });
+};
+
+const pluginModule: TuiPluginModule & { id: string } = {
+  id,
+  tui,
+};
+
+export default pluginModule;

package/tsconfig.json

@@ -19,6 +19,6 @@
     "isolatedModules": true,
     "types": ["node"]
   },
-  "include": ["src/**/*.ts"],
+  "include": ["src/**/*.ts", "src/**/*.tsx"],
   "exclude": ["node_modules", "dist"]
 }