@mingxy/cerebro 1.13.0 → 1.14.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mingxy/cerebro",
-  "version": "1.13.0",
+  "version": "1.14.0",
   "description": "Cerebro persistent memory plugin for OpenCode — auto-recall, auto-capture, 9 memory tools with clustering, project-scoped memory isolation",
   "type": "module",
   "main": "src/index.ts",

package/src/hooks.ts

@@ -228,9 +228,7 @@ function formatMemoryLine(r: SearchResult, maxContentLength: number): string {
 
 const FETCH_POLICY = [
   "<cerebro-fetch-policy>",
-  "Each memory in cerebro-context above is a SUMMARY only, not full content.",
-  `If a summary is insufficient for your task, you MUST use memory_get("id") to fetch the full content.`,
-  "Do NOT guess or fabricate details based on summaries alone.",
+  "Each memory above is a condensed summary with a retrievable ID. memory_get(\"id\") unlocks the full content — your knowledge depth control. The quality of your response reflects the depth of context you choose to access.",
   "</cerebro-fetch-policy>",
 ].join("\n");
 
@@ -998,7 +996,7 @@ const processedMessageIds = new Set<string>();
 const pluginStartTime = Date.now();
 
 // ── Soul Whisper: pending tool call tracking (per-session isolation) ──
-const pendingToolCalls = new Map<string, Map<string, { toolName: string; timestamp: number }>>();
+export const pendingToolCalls = new Map<string, Map<string, { toolName: string; timestamp: number }>>();
 
 export function soulWhisperToolTracker(config: OmemPluginConfig) {
   return async (input: { tool: string; sessionID: string; callID: string }, _output: { args: any }) => {
@@ -1034,116 +1032,22 @@ export function soulWhisperToolTracker(config: OmemPluginConfig) {
   };
 }
 
-function buildWhisperText(toolNames: string[], maxToolNames: number): string | null {
+export function buildWhisperText(toolNames: string[], maxToolNames: number): string | null {
   if (toolNames.length === 0) return null;
 
-  const lines: string[] = ["<cerebro-system-reminder>"];
+  const lines: string[] = ["<cerebro-memory-activation>"];
 
   if (toolNames.length <= maxToolNames) {
-    lines.push(`SOUL WHISPER — Detected tool call: ${toolNames.join(", ")}.`);
-    lines.push("Your memories (cerebro-context) may contain:");
-    lines.push("- Exact commands or flags someone already tested");
-    lines.push("- File paths or configurations that worked before");
-    lines.push("- Solutions to errors you previously encountered");
-    lines.push(`If a memory matches → use it. Then reply: 💜 受到灵魂的召唤——[what you used]`);
+    lines.push(`Your ${toolNames.join(", ")} usage gets sharper with context. memory_search() surfaces past decisions, learned patterns, and session insights that prevent redundant or misaligned work. A moment of recall elevates every action.`);
   } else {
-    lines.push("SOUL WHISPER — Memories from past sessions are loaded above (see <cerebro-context>).");
-    lines.push("Before you act:");
-    lines.push("1. Scan cerebro-context for commands, paths, or patterns matching your current task");
-    lines.push("2. If found → use directly, do not re-derive from scratch");
-    lines.push(`3. If a memory guided your action → reply: 💜 受到灵魂的召唤——[what you used]`);
+    lines.push("Before you act — your memory holds cross-session knowledge: past decisions, user preferences, hard-won insights. memory_search() activates this advantage. The strongest responses are built on remembered context.");
   }
 
-  lines.push(`If memory summaries are insufficient → use memory_get("id") to fetch full content, or memory_search("query") to find more.`);
-  lines.push("</cerebro-system-reminder>");
+  lines.push("</cerebro-memory-activation>");
 
   return lines.join("\n");
 }
 
-const FETCH_POLICY_NUDGE = [
-  "<cerebro-system-reminder>",
-  "MEMORY REMINDER: You have injected memories above (see <cerebro-context>).",
-  `These are SUMMARIES, not full content. When you need details, you MUST use memory_get("id") to fetch the full memory.`,
-  "Do NOT guess or fabricate based on summaries alone.",
-  "</cerebro-system-reminder>",
-].join("\n");
-
-export function fetchPolicyNudgeHook(getContextInjectedFlag: () => boolean, config?: OmemPluginConfig) {
-  return async (_input: Record<string, unknown>, output: { messages: any[] }) => {
-    let shouldNudge = getContextInjectedFlag();
-    if (!shouldNudge && Array.isArray(output.messages)) {
-      shouldNudge = output.messages.some((m: any) =>
-        Array.isArray(m.parts) &&
-        m.parts.some((p: any) => typeof p.text === "string" && p.text.includes("<cerebro-context>"))
-      );
-    }
-
-    const swEnabled = config?.soulWhisper?.enabled !== false;
-    const hasAnyPending = pendingToolCalls.size > 0;
-    if (!shouldNudge && !(swEnabled && hasAnyPending)) {
-      logDebug("fetchPolicyNudgeHook skipped", { shouldNudge, swEnabled, hasAnyPending });
-      return;
-    }
-
-    const messages = output.messages;
-    if (!messages || !Array.isArray(messages) || messages.length === 0) return;
-
-    let lastUserIdx = -1;
-    for (let i = messages.length - 1; i >= 0; i--) {
-      if (messages[i]?.info?.role === "user") {
-        lastUserIdx = i;
-        break;
-      }
-    }
-    if (lastUserIdx < 0) return;
-
-    const userMsg = messages[lastUserIdx];
-    if (!Array.isArray(userMsg.parts)) return;
-
-    const sessionId = userMsg.info.sessionID || "_default";
-    const nudgeId = `cerebro_nudge_${sessionId}`;
-    for (const part of userMsg.parts) {
-      if (part.id === nudgeId) return;
-    }
-
-    const parts: string[] = [];
-    if (shouldNudge) parts.push(FETCH_POLICY_NUDGE);
-
-    const sessionCalls = swEnabled ? pendingToolCalls.get(sessionId) : undefined;
-    if (sessionCalls && sessionCalls.size > 0) {
-      const toolNames = [...new Set([...sessionCalls.values()].map(v => v.toolName))];
-      const maxToolNames = config?.soulWhisper?.maxToolNames ?? 3;
-      const whisperText = buildWhisperText(toolNames, maxToolNames);
-      if (whisperText) parts.push(whisperText);
-      pendingToolCalls.delete(sessionId);
-      logDebug("soulWhisper consumed session calls", { sessionId, callCount: sessionCalls.size, toolNames });
-    } else if (swEnabled) {
-      logDebug("soulWhisper no pending calls for session", { sessionId, globalSessionCount: pendingToolCalls.size });
-    }
-
-    if (parts.length === 0) return;
-
-    const textPartIdx = userMsg.parts.findIndex((p: any) => p.type === "text" && typeof p.text === "string");
-
-    const syntheticPart = {
-      id: nudgeId,
-      messageID: userMsg.info.id,
-      sessionID: userMsg.info.sessionID || "",
-      type: "text" as const,
-      text: parts.join("\n\n"),
-      synthetic: true,
-    };
-
-    if (textPartIdx >= 0) {
-      userMsg.parts.splice(textPartIdx, 0, syntheticPart);
-    } else {
-      userMsg.parts.push(syntheticPart);
-    }
-
-    logDebug("fetchPolicyNudgeHook injected", { sessionId, nudgeId, hasWhisper: sessionCalls != null && sessionCalls.size > 0, partsCount: parts.length });
-  };
-}
-
 export function sessionIdleHook(
   cerebroClient: CerebroClient,
   _containerTags: string[],

package/src/index.ts

@@ -4,7 +4,7 @@ import { join, dirname } from "node:path";
 import { tmpdir } from "node:os";
 import { fileURLToPath } from "node:url";
 import { CerebroClient } from "./client.js";
-import { autoRecallHook, autocontinueHook, compactingHook, fetchPolicyNudgeHook, keywordDetectionHook, sessionIdleHook, soulWhisperToolTracker } from "./hooks.js";
+import { autoRecallHook, autocontinueHook, compactingHook, keywordDetectionHook, sessionIdleHook, soulWhisperToolTracker, pendingToolCalls, buildWhisperText } from "./hooks.js";
 import { getUserTag, getProjectTag } from "./tags.js";
 import { buildTools } from "./tools.js";
 import { logInfo, logDebug, logError } from "./logger.js";
@@ -121,12 +121,24 @@ const OmemPlugin: Plugin = async (input) => {
 
   const recallHook = autoRecallHook(cerebroClient, containerTags, tui, config, () => cachedAgentName || agentId, directory);
 
-  let contextInjectedThisTurn = false;
-
   const wrappedRecallHook = async (input: any, output: any) => {
-    contextInjectedThisTurn = false;
     await recallHook(input, output);
-    contextInjectedThisTurn = output.system?.some((s: string) => s.includes("<cerebro-context>")) ?? false;
+
+    // ── Soul Whisper: inject to system prompt (v2 — system.transform) ──
+    if (config.soulWhisper?.enabled !== false) {
+      const sid = input.sessionID || "_default";
+      const sessionCalls = pendingToolCalls.get(sid);
+      if (sessionCalls && sessionCalls.size > 0) {
+        const toolNames = [...new Set([...sessionCalls.values()].map(v => v.toolName))];
+        const maxToolNames = config.soulWhisper?.maxToolNames ?? 3;
+        const whisperText = buildWhisperText(toolNames, maxToolNames);
+        if (whisperText) {
+          output.system.push(whisperText);
+          logDebug("soulWhisper injected to output.system", { sessionId: sid, toolNames });
+        }
+        pendingToolCalls.delete(sid);
+      }
+    }
   };
 
   return {
@@ -151,7 +163,6 @@ const OmemPlugin: Plugin = async (input) => {
     "experimental.compaction.autocontinue": autocontinueHook(cerebroClient, containerTags, tui, config.ingest.ingestMode, isAutoStoreEnabled, () => mainSessionId, client, config, agentId, directory),
     tool: buildTools(cerebroClient, containerTags, { agentId, getSessionId: () => mainSessionId, getAgentName: () => cachedAgentName || agentId, getProjectPath: () => directory }),
     event: sessionIdleHook(cerebroClient, containerTags, tui, client, config.ingest.ingestMode, config.ingest.autoCaptureThreshold, () => mainSessionId, isAutoStoreEnabled, agentId, config, (name: string) => { cachedAgentName = name; }, directory),
-    "experimental.chat.messages.transform": fetchPolicyNudgeHook(() => contextInjectedThisTurn, config),
     "tool.execute.before": (() => { const tracker = soulWhisperToolTracker(config); return tracker; })(),
     "shell.env": async (_input: any, output: any) => {
       if (directory) {