@bd7pil/opencode-deep-memory 0.3.5 → 0.3.6

package/README.md

@@ -49,7 +49,7 @@ OpenCode auto-installs on startup. Memory appears at `.deep-memory/` in your pro
 ┌─────────────────────┴───────────────────────┐
 │                  event                      │
 │  session.created → resume + dream schedule  │
-│  session.idle    → enrichment               │
+│  session.idle    → enrichment + notify      │
 │  session.compacted → checkpoint             │
 └─────────────────────────────────────────────┘
 ```
@@ -74,6 +74,30 @@ with sentinels so message structure stays intact and prompt caching is preserved
 **Never touched**: user messages (anchor turn boundaries), recent 8 messages (working context),
 tool calls and their results (API pairing integrity).
 
+## Toast notifications
+
+After each LLM turn, deep-memory shows a toast notification (bottom-right corner) summarizing
+what was compressed and injected. The notification level is chosen automatically:
+
+| Scenario | Level | Content |
+|----------|-------|---------|
+| Injection only (no compression) | minimal | One-line summary: `-8.5K stripped` |
+| Compression (short session) | detailed | Progress bar + per-category breakdown |
+| Compression + rich context (repo-map, memory, checkpoint) | extended | Full panel with budget usage |
+
+Example toast (detailed level):
+
+```
+deep-memory | compressed
+─ Compression ─────────────────────────────
+│████░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░│
+  reasoning -6.2K | metadata -2.1K | tool_err -0.8K
+─ Injection ───────────────────────────────
+  m[0] stable 1055B ✓  m[1] volatile 574B
+  tier=main | mode=normal
+  repo-map: 12 symbols | memory: 8 entries
+```
+
 ## Cache-stable injection
 
 Each turn pushes two system prompt fragments:

package/dist/index.js

@@ -256,6 +256,7 @@ var PluginState = class {
   _pendingResumes = /* @__PURE__ */ new Map();
   _pendingEnrichments = /* @__PURE__ */ new Set();
   _lastUserText = /* @__PURE__ */ new Map();
+  _pendingNotify = null;
   agentOf(sessionID) {
     return this._agents.get(sessionID);
   }
@@ -341,6 +342,37 @@ var PluginState = class {
     this._lastUserText.delete(sessionID);
     return text;
   }
+  /**
+   * Merge stats into the pending notification.
+   * Called from messages.transform (compression) and system.transform (injection).
+   * Creates a new PendingNotify on first call per turn.
+   */
+  mergeNotify(patch) {
+    if (!this._pendingNotify) {
+      this._pendingNotify = { ...patch, setAt: Date.now() };
+      return;
+    }
+    if (patch.compression) {
+      this._pendingNotify.compression = patch.compression;
+    }
+    if (patch.injection) {
+      this._pendingNotify.injection = patch.injection;
+    }
+    if (patch.messageCount !== void 0) {
+      this._pendingNotify.messageCount = patch.messageCount;
+    }
+    if (patch.protectedHead !== void 0) {
+      this._pendingNotify.protectedHead = patch.protectedHead;
+    }
+    if (patch.protectedTail !== void 0) {
+      this._pendingNotify.protectedTail = patch.protectedTail;
+    }
+  }
+  consumePendingNotify() {
+    const n = this._pendingNotify;
+    this._pendingNotify = null;
+    return n;
+  }
 };
 function createPluginState() {
   return new PluginState();
@@ -777,7 +809,8 @@ async function composeSystemPayload(opts) {
       stable: `<deep-memory-stable>
 <tool-hint>${TOOL_HINT}</tool-hint>
 </deep-memory-stable>`,
-      volatile: ""
+      volatile: "",
+      stats: { searchEntries: 0, repoMapEntries: 0, hasCheckpoint: false }
     };
   }
   const staticBudget = Math.floor(budget.memorySummary * 0.4);
@@ -794,6 +827,7 @@ ${staticMemory || "(empty)"}
 </constraints>
 </deep-memory-stable>`;
   let volatileContent = "";
+  let searchEntries = 0;
   if (userQuery && searchService && searchBudget > 0) {
     try {
       const results = await searchService.search(userQuery, { scope: "all", limit: 20, applyDecay: true });
@@ -808,12 +842,14 @@ ${staticMemory || "(empty)"}
           })),
           { budget: searchBudget }
         );
+        searchEntries = allocated.length;
         volatileContent = allocated.map((a) => a.rendered).join("\n");
       }
     } catch {
     }
   }
   let checkpointContent = "";
+  let hasCheckpoint = false;
   if (budget.checkpointSummary > 0) {
     const checkpointPath = memoryFilePath("project", "checkpoint", projectPath);
     checkpointContent = budgetedRead(checkpointPath, budget.checkpointSummary, [
@@ -823,6 +859,7 @@ ${staticMemory || "(empty)"}
       "Gotchas",
       "File Changes"
     ]);
+    hasCheckpoint = !!checkpointContent;
   }
   let volatile = `<deep-memory-volatile>
 <relevant>
@@ -834,9 +871,11 @@ ${volatileContent || "(none)"}
 ${checkpointContent}
 </last-checkpoint>`;
   }
+  let repoMapSymbols = 0;
   if (tracker && budget.repomap > 0) {
     const repomapEntries = tracker.getTopSymbols(budget.repomap);
     if (repomapEntries.length > 0) {
+      repoMapSymbols = repomapEntries.length;
       volatile += "\n" + formatRepoMap(repomapEntries);
     }
   }
@@ -849,7 +888,7 @@ ${checkpointContent}
     stableSize: stable.length,
     volatileSize: volatile.length
   });
-  return { stable, volatile };
+  return { stable, volatile, stats: { searchEntries, repoMapEntries: repoMapSymbols, hasCheckpoint } };
 }
 
 // src/hooks/system-transform.ts
@@ -870,7 +909,7 @@ function createSystemTransformHandler(state, projectPath, searchService, logger,
       }
     }
     const userQuery = state.consumeLastUserText(sessionID);
-    const { stable, volatile } = await composeSystemPayload({
+    const { stable, volatile, stats: payloadStats } = await composeSystemPayload({
       state,
       sessionID,
       projectPath,
@@ -896,6 +935,17 @@ function createSystemTransformHandler(state, projectPath, searchService, logger,
       stableSize: stable.length,
       volatileSize: volatile.length
     });
+    state.mergeNotify({
+      injection: {
+        stableSize: stable.length,
+        volatileSize: volatile.length,
+        tier,
+        mode,
+        searchEntries: payloadStats.searchEntries,
+        repoMapEntries: payloadStats.repoMapEntries,
+        hasCheckpoint: payloadStats.hasCheckpoint
+      }
+    });
   };
 }
 
@@ -15166,7 +15216,7 @@ function repairOrphanedToolCalls(messages) {
     }
   }
 }
-function createMessagesTransformHandler(_state, logger) {
+function createMessagesTransformHandler(state, logger) {
   return async (_input, output) => {
     const messages = output.messages;
     if (messages.length <= KEEP_RECENT) return;
@@ -15238,6 +15288,132 @@ function createMessagesTransformHandler(_state, logger) {
     repairOrphanedToolCalls(messages);
     if (Object.values(stats).some((v) => v > 0)) {
       logger?.debug("messages.transform: stripped", stats);
+      state.mergeNotify({
+        compression: stats,
+        messageCount: messages.length,
+        protectedHead: PROTECTED_HEAD,
+        protectedTail: KEEP_RECENT
+      });
+    }
+  };
+}
+
+// src/hooks/notify.ts
+var COOLDOWN_MS = 5e3;
+function formatK(n) {
+  if (n >= 1e3) return `${(n / 1e3).toFixed(1).replace(/\.0$/, "")}K`;
+  return String(n);
+}
+function totalStripped(c) {
+  return c.reasoning_cleared + c.metadata_stripped + c.system_neutralized + c.tool_errors_truncated + c.thinking_stripped;
+}
+function renderProgressBar(total, processed, width = 40) {
+  if (total === 0) return `\u2502${"\u2591".repeat(width)}\u2502`;
+  const filled = Math.round(processed / total * width);
+  const bar = "\u2588".repeat(Math.min(filled, width)) + "\u2591".repeat(Math.max(0, width - filled));
+  return `\u2502${bar}\u2502`;
+}
+function formatCompressionBlock(c, msgCount, head, tail) {
+  const lines = [];
+  if (msgCount && msgCount > 0) {
+    const protectedZones = (head ?? 0) + (tail ?? 0);
+    const scannable = Math.max(0, msgCount - protectedZones);
+    const affected = Math.min(scannable, totalStripped(c));
+    lines.push(renderProgressBar(scannable, affected));
+  }
+  const parts = [];
+  if (c.reasoning_cleared > 0) parts.push(`reasoning -${formatK(c.reasoning_cleared)}`);
+  if (c.metadata_stripped > 0) parts.push(`metadata -${formatK(c.metadata_stripped)}`);
+  if (c.tool_errors_truncated > 0) parts.push(`tool_err -${formatK(c.tool_errors_truncated)}`);
+  if (c.thinking_stripped > 0) parts.push(`thinking -${formatK(c.thinking_stripped)}`);
+  if (c.system_neutralized > 0) parts.push(`sys_inject -${formatK(c.system_neutralized)}`);
+  if (parts.length > 0) lines.push(`  ${parts.join(" | ")}`);
+  return lines.join("\n");
+}
+function formatInjectionBlock(i) {
+  const cacheStatus = i.stableSize > 0 ? "\u2713" : "\u2014";
+  const lines = [
+    `  m[0] stable ${formatK(i.stableSize)}B ${cacheStatus}  m[1] volatile ${formatK(i.volatileSize)}B`,
+    `  tier=${i.tier} | mode=${i.mode}`
+  ];
+  const details = [];
+  if (i.repoMapEntries > 0) details.push(`repo-map: ${i.repoMapEntries} symbols`);
+  if (i.searchEntries > 0) details.push(`memory: ${i.searchEntries} entries`);
+  if (i.hasCheckpoint) details.push(`checkpoint \u2713`);
+  if (details.length > 0) lines.push(`  ${details.join(" | ")}`);
+  return lines.join("\n");
+}
+function chooseLevel(n) {
+  if (!n.compression && n.injection) return "minimal";
+  if (!n.compression) return "minimal";
+  const hasRichContext = n.injection && (n.injection.repoMapEntries > 0 || n.injection.searchEntries > 0 || n.injection.hasCheckpoint);
+  if (hasRichContext && n.messageCount && n.messageCount > 20) return "extended";
+  return "detailed";
+}
+function formatNotify(n) {
+  const level = chooseLevel(n);
+  if (level === "minimal") {
+    const parts = ["\u25A3 deep-memory"];
+    if (n.compression) parts.push(`-${formatK(totalStripped(n.compression))} stripped`);
+    if (n.injection) parts.push(`+${formatK(n.injection.stableSize + n.injection.volatileSize)}B injected`);
+    return parts.join(" | ");
+  }
+  if (level === "extended") {
+    const sections2 = [];
+    if (n.compression) {
+      sections2.push("\u2500 Compression \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500");
+      if (n.messageCount) {
+        const head = n.protectedHead ?? 0;
+        const tail = n.protectedTail ?? 0;
+        sections2.push(`  messages: ${n.messageCount} (protected: head=${head} tail=${tail})`);
+      }
+      sections2.push(formatCompressionBlock(n.compression, n.messageCount, n.protectedHead, n.protectedTail));
+    }
+    if (n.injection) {
+      sections2.push("\u2500 Injection \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500");
+      sections2.push(formatInjectionBlock(n.injection));
+      const budgetUsed = n.injection.stableSize + n.injection.volatileSize;
+      const maxBudget = 4e3;
+      const pct = Math.round(budgetUsed / maxBudget * 100);
+      sections2.push(`  budget: ${formatK(budgetUsed)}B / ${formatK(maxBudget)}B (${pct}%)`);
+    }
+    return ["\u25A3 deep-memory", ...sections2].join("\n");
+  }
+  const sections = [];
+  if (n.compression) {
+    sections.push("\u2500 Compression \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500");
+    sections.push(formatCompressionBlock(n.compression, n.messageCount, n.protectedHead, n.protectedTail));
+  }
+  if (n.injection) {
+    sections.push("\u2500 Injection \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500");
+    sections.push(formatInjectionBlock(n.injection));
+  }
+  return ["\u25A3 deep-memory", ...sections].join("\n");
+}
+function createNotifyHandler(client, logger) {
+  let lastNotifyAt = 0;
+  return async (sessionID, notify) => {
+    const hasCompression = notify.compression && totalStripped(notify.compression) > 0;
+    const hasInjection = !!notify.injection;
+    if (!hasCompression && !hasInjection) return;
+    if (notify.setAt - lastNotifyAt < COOLDOWN_MS) return;
+    lastNotifyAt = Date.now();
+    const message = formatNotify(notify);
+    const title = hasCompression ? "deep-memory | compressed" : "deep-memory | injected";
+    try {
+      await client.tui.showToast({
+        body: {
+          title,
+          message,
+          variant: "info",
+          duration: 5e3
+        }
+      });
+      logger?.debug("notify: sent", { level: chooseLevel(notify) });
+    } catch (err) {
+      logger?.debug("notify: failed (non-fatal)", {
+        error: err instanceof Error ? err.message : String(err)
+      });
     }
   };
 }
@@ -15595,8 +15771,12 @@ var deepMemoryPlugin = async (input) => {
     });
   });
   const memoryTools = createMemoryTools(searchService, { projectPath });
+  const notify = createNotifyHandler(input.client, logger.for("notify"));
   const hooks = {
-    "chat.params": createChatParamsHandler(state, logger.for("chat-params")),
+    "chat.params": createChatParamsHandler(
+      state,
+      logger.for("chat-params")
+    ),
     "chat.message": createChatMessageHandler({
       projectPath,
       state,
@@ -15666,6 +15846,18 @@ var deepMemoryPlugin = async (input) => {
           } else {
             logger.debug("event session.idle (no pending enrichment)");
           }
+          if (idleSessionID) {
+            const pending = state.consumePendingNotify();
+            if (pending) {
+              try {
+                await notify(idleSessionID, pending);
+              } catch (err) {
+                logger.debug("idle notify failed (non-fatal)", {
+                  error: err instanceof Error ? err.message : String(err)
+                });
+              }
+            }
+          }
           return;
         }
         if (event.type === "session.compacted") {