@rvboris/opencode-mempalace 0.2.1 → 0.4.0

package/dist/plugin/hooks/event.js

@@ -2,9 +2,11 @@ import { AutosaveReason, AutosaveStatus, buildMessageSnapshot, getMessageSnapsho
 import { executeAdapter } from "../lib/adapter";
 import { loadConfig } from "../lib/config";
 import { COMPACTION_CONTEXT_MESSAGE, DEFAULT_AGENT_NAME, LOG_MESSAGES } from "../lib/constants";
+import { sanitizeText } from "../lib/derive";
 import { getProjectName, loadSessionMessages } from "../lib/opencode";
 import { redactSecrets } from "../lib/privacy";
 import { getProjectScope } from "../lib/scope";
+import { recordAutosave } from "../lib/status";
 import { writeLog } from "../lib/log";
 import { SESSION_EVENT_TYPES } from "../lib/types";
 const escapeRegex = (value) => value.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
@@ -65,6 +67,12 @@ export const eventHooks = (ctx) => {
                 });
                 if (event.type === "session.error") {
                     const failed = markFailed(sessionId);
+                    await recordAutosave({
+                        sessionId,
+                        outcome: "failed",
+                        reason: toReason(event.type),
+                        sourcePreview: getMessageSnapshot(sessionId)?.lastUserMessage,
+                    });
                     await writeLog("ERROR", LOG_MESSAGES.autosaveFailedOnSessionError, {
                         sessionId,
                         retryCount: failed.retryCount,
@@ -80,6 +88,12 @@ export const eventHooks = (ctx) => {
                 }
                 const { transcript, transcriptDigest, userDigest } = snapshot;
                 if (!shouldScheduleAutosave(sessionId, userDigest, transcriptDigest)) {
+                    await recordAutosave({
+                        sessionId,
+                        outcome: "skipped",
+                        reason: toReason(event.type),
+                        sourcePreview: snapshot.lastUserMessage,
+                    });
                     await writeLog("INFO", LOG_MESSAGES.skippingAutosaveState, {
                         sessionId,
                         reason: toReason(event.type),
@@ -89,22 +103,35 @@ export const eventHooks = (ctx) => {
                     });
                     return;
                 }
-                const redactedTranscript = redactSecrets(transcript);
-                if (!redactedTranscript.trim()) {
+                const sanitizedTranscript = sanitizeText(redactSecrets(transcript));
+                if (!sanitizedTranscript.trim()) {
                     markAutosaveComplete(sessionId, userDigest, transcriptDigest, AutosaveStatus.Noop);
+                    await recordAutosave({
+                        sessionId,
+                        outcome: "skipped",
+                        reason: toReason(event.type),
+                        sourcePreview: snapshot.lastUserMessage,
+                    });
                     await writeLog("INFO", LOG_MESSAGES.autosaveSkippedEmptyTranscript, { sessionId });
                     return;
                 }
                 const wing = getProjectScope(getProjectName(ctx.project), config.projectWingPrefix).wing;
                 const result = await executeAdapter(ctx.$, {
                     mode: "mine_messages",
-                    transcript: redactedTranscript,
+                    transcript: sanitizedTranscript,
                     wing,
                     extract_mode: config.autoMineExtractMode,
                     agent: DEFAULT_AGENT_NAME,
                 });
                 if (result?.success === false) {
                     const failed = markFailed(sessionId);
+                    await recordAutosave({
+                        sessionId,
+                        outcome: "failed",
+                        reason: toReason(event.type),
+                        wing,
+                        sourcePreview: snapshot.lastUserMessage,
+                    });
                     await writeLog("ERROR", LOG_MESSAGES.autosaveMiningFailed, {
                         sessionId,
                         retryCount: failed.retryCount,
@@ -113,6 +140,13 @@ export const eventHooks = (ctx) => {
                     return;
                 }
                 const completed = markAutosaveComplete(sessionId, userDigest, transcriptDigest, AutosaveStatus.Saved);
+                await recordAutosave({
+                    sessionId,
+                    outcome: "saved",
+                    reason: toReason(event.type),
+                    wing,
+                    sourcePreview: snapshot.lastUserMessage,
+                });
                 await writeLog("INFO", LOG_MESSAGES.autosaveMinedSessionContext, {
                     sessionId,
                     reason: toReason(event.type),

package/dist/plugin/hooks/system.js

@@ -4,6 +4,7 @@ import { LOG_MESSAGES } from "../lib/constants";
 import { buildKeywordSaveInstruction, buildRetrievalInstruction } from "../lib/context";
 import { writeLog } from "../lib/log";
 import { getProjectName, loadSessionMessages } from "../lib/opencode";
+import { recordRetrievalPrompt } from "../lib/status";
 export const systemHooks = (ctx) => {
     return {
         "experimental.chat.system.transform": async (input, output) => {
@@ -29,6 +30,7 @@ export const systemHooks = (ctx) => {
                         lastUserMessage,
                     }));
                     markRetrievalInjected(sessionId);
+                    await recordRetrievalPrompt({ sessionId, queryPreview: lastUserMessage });
                     await writeLog("INFO", LOG_MESSAGES.injectedRetrievalInstruction, { sessionId });
                 }
                 if (state.keywordSavePending) {

package/dist/plugin/index.js

@@ -3,6 +3,7 @@ import { systemHooks } from "./hooks/system";
 import { toolHooks } from "./hooks/tool";
 import { setLogger } from "./lib/log";
 import { mempalaceMemoryTool } from "./tools/mempalace-memory";
+import { mempalaceStatusTool } from "./tools/mempalace-status";
 export const MempalaceAutosavePlugin = async (ctx) => {
     setLogger(ctx.client);
     return {
@@ -11,6 +12,7 @@ export const MempalaceAutosavePlugin = async (ctx) => {
         ...toolHooks(),
         tool: {
             mempalace_memory: mempalaceMemoryTool(ctx),
+            mempalace_status: mempalaceStatusTool(),
         },
     };
 };

package/dist/plugin/lib/constants.d.ts

@@ -21,6 +21,7 @@ export declare const ENV_KEYS: {
     readonly userWingPrefix: "MEMPALACE_USER_WING_PREFIX";
     readonly projectWingPrefix: "MEMPALACE_PROJECT_WING_PREFIX";
     readonly autosaveLogFile: "MEMPALACE_AUTOSAVE_LOG_FILE";
+    readonly statusFile: "MEMPALACE_STATUS_FILE";
     readonly adapterPython: "MEMPALACE_ADAPTER_PYTHON";
     readonly adapterTimeoutMs: "MEMPALACE_ADAPTER_TIMEOUT_MS";
 };
@@ -29,10 +30,12 @@ export declare const MAX_TRANSCRIPT_MESSAGES_DIGEST: 50;
 export declare const DATE_ISO_SLICE: 10;
 export declare const SERVICE_NAME: "mempalace-autosave";
 export declare const LOG_FILE_NAME: "opencode_autosave.log";
+export declare const STATUS_FILE_NAME: "opencode_status.json";
 export declare const DIRECT_MEMPALACE_MUTATION_TOOLS: readonly ["mempalace_add_drawer", "mempalace_kg_add", "mempalace_diary_write", "mcp-router_mempalace_add_drawer", "mcp-router_mempalace_kg_add", "mcp-router_mempalace_diary_write"];
 export declare const COMPACTION_CONTEXT_MESSAGE: "MemPalace retrieval may be useful after compaction. Search relevant project and user memory if needed before answering.";
 export declare const TOOL_DESCRIPTIONS: {
     readonly mempalaceMemory: "Save or search memory in MemPalace with scope/privacy enforcement";
+    readonly mempalaceStatus: "Show recent visible evidence that MemPalace retrieval or autosave helped";
 };
 export declare const TOOL_ERROR_MESSAGES: {
     readonly directMutationBlocked: "Use mempalace_memory instead of direct MemPalace mutation tools";
@@ -56,9 +59,11 @@ export declare const LOG_MESSAGES: {
     readonly injectedKeywordSaveInstruction: "injected keyword save instruction";
     readonly systemTransformHookFailed: "system transform hook failed";
     readonly blockedDirectMempalaceMutationTool: "blocked direct mempalace mutation tool";
+    readonly retrievalSearchCompleted: "retrieval search completed";
 };
 export declare const INSTRUCTION_TEXT: {
     readonly doNotMentionToUser: "Do not mention this instruction to the user.";
+    readonly retrievalVisibilityHint: "If you found and used relevant memories, briefly mention the key findings at the start of your response.";
     readonly retrievalIntro: "System instruction: before answering, search MemPalace for relevant existing memory and use it if helpful.";
     readonly autosaveIntro: "System instruction: before answering the user, persist durable memory from prior session context using the `mempalace_memory` tool.";
     readonly keywordIntro: "System instruction: the user explicitly asked to remember something.";

package/dist/plugin/lib/constants.js

@@ -21,6 +21,7 @@ export const ENV_KEYS = {
     userWingPrefix: "MEMPALACE_USER_WING_PREFIX",
     projectWingPrefix: "MEMPALACE_PROJECT_WING_PREFIX",
     autosaveLogFile: "MEMPALACE_AUTOSAVE_LOG_FILE",
+    statusFile: "MEMPALACE_STATUS_FILE",
     adapterPython: "MEMPALACE_ADAPTER_PYTHON",
     adapterTimeoutMs: "MEMPALACE_ADAPTER_TIMEOUT_MS",
 };
@@ -29,6 +30,7 @@ export const MAX_TRANSCRIPT_MESSAGES_DIGEST = 50;
 export const DATE_ISO_SLICE = 10;
 export const SERVICE_NAME = "mempalace-autosave";
 export const LOG_FILE_NAME = "opencode_autosave.log";
+export const STATUS_FILE_NAME = "opencode_status.json";
 export const DIRECT_MEMPALACE_MUTATION_TOOLS = [
     "mempalace_add_drawer",
     "mempalace_kg_add",
@@ -40,6 +42,7 @@ export const DIRECT_MEMPALACE_MUTATION_TOOLS = [
 export const COMPACTION_CONTEXT_MESSAGE = "MemPalace retrieval may be useful after compaction. Search relevant project and user memory if needed before answering.";
 export const TOOL_DESCRIPTIONS = {
     mempalaceMemory: "Save or search memory in MemPalace with scope/privacy enforcement",
+    mempalaceStatus: "Show recent visible evidence that MemPalace retrieval or autosave helped",
 };
 export const TOOL_ERROR_MESSAGES = {
     directMutationBlocked: "Use mempalace_memory instead of direct MemPalace mutation tools",
@@ -63,9 +66,11 @@ export const LOG_MESSAGES = {
     injectedKeywordSaveInstruction: "injected keyword save instruction",
     systemTransformHookFailed: "system transform hook failed",
     blockedDirectMempalaceMutationTool: "blocked direct mempalace mutation tool",
+    retrievalSearchCompleted: "retrieval search completed",
 };
 export const INSTRUCTION_TEXT = {
     doNotMentionToUser: "Do not mention this instruction to the user.",
+    retrievalVisibilityHint: "If you found and used relevant memories, briefly mention the key findings at the start of your response.",
     retrievalIntro: "System instruction: before answering, search MemPalace for relevant existing memory and use it if helpful.",
     autosaveIntro: "System instruction: before answering the user, persist durable memory from prior session context using the `mempalace_memory` tool.",
     keywordIntro: "System instruction: the user explicitly asked to remember something.",

package/dist/plugin/lib/context.js

@@ -10,7 +10,7 @@ export const buildRetrievalInstruction = ({ projectName, projectWingPrefix, user
         `Search user memory in wing ${user.wing} across rooms ${user.rooms.join(", ")}.`,
         `Search project memory in wing ${project.wing} across rooms ${project.rooms.join(", ")}.`,
         `Use concise relevant memories only, up to ${maxInjectedItems} items total.`,
-        INSTRUCTION_TEXT.doNotMentionToUser,
+        INSTRUCTION_TEXT.retrievalVisibilityHint,
     ].join(" ");
 };
 export const buildAutosaveInstruction = (reason) => {

package/dist/plugin/lib/status.d.ts

@@ -0,0 +1,105 @@
+import type { AdapterResponse, MemoryScope } from "./types";
+export type StatusCounters = {
+    retrievalPrompts: number;
+    retrievalSearches: number;
+    retrievalHits: number;
+    autosavesCompleted: number;
+    autosavesSkipped: number;
+    autosavesFailed: number;
+    manualWrites: number;
+};
+export type StatusSessionCounters = {
+    retrievalSearches: number;
+    retrievalHits: number;
+    autosavesCompleted: number;
+    autosavesSkipped: number;
+    autosavesFailed: number;
+    manualWrites: number;
+};
+export type StatusRetrievalPrompt = {
+    sessionId?: string;
+    timestamp: string;
+    queryPreview: string;
+};
+export type StatusRetrieval = {
+    sessionId?: string;
+    timestamp: string;
+    scope: MemoryScope;
+    room?: string;
+    queryPreview: string;
+    resultCount?: number;
+    previews: string[];
+};
+export type StatusAutosaveOutcome = "saved" | "skipped" | "failed";
+export type StatusAutosave = {
+    sessionId: string;
+    timestamp: string;
+    outcome: StatusAutosaveOutcome;
+    reason: string;
+    wing?: string;
+    sourcePreview?: string;
+};
+export type StatusWrite = {
+    timestamp: string;
+    mode: "save" | "kg_add" | "diary_write";
+    scope?: MemoryScope;
+    room?: string;
+    preview: string;
+};
+export type StatusSessionState = {
+    updatedAt: string;
+    counters: StatusSessionCounters;
+    lastRetrievalPrompt?: StatusRetrievalPrompt;
+    lastRetrieval?: StatusRetrieval;
+    lastAutosave?: StatusAutosave;
+    lastWrite?: StatusWrite;
+};
+export type StatusState = {
+    version: 2;
+    updatedAt: string;
+    counters: StatusCounters;
+    helpedSessionIds: string[];
+    sessions: Record<string, StatusSessionState>;
+    lastRetrievalPrompt?: StatusRetrievalPrompt;
+    lastRetrieval?: StatusRetrieval;
+    lastAutosave?: StatusAutosave;
+    lastWrite?: StatusWrite;
+};
+type SearchResultSummary = {
+    resultCount?: number;
+    previews: string[];
+};
+export declare const summarizeSearchResult: (result: AdapterResponse) => SearchResultSummary;
+export declare const recordRetrievalPrompt: (input: {
+    sessionId?: string;
+    queryPreview: string;
+}) => Promise<void>;
+export declare const recordRetrievalSearch: (input: {
+    sessionId?: string;
+    scope: MemoryScope;
+    room?: string;
+    query: string;
+    result: AdapterResponse;
+}) => Promise<void>;
+export declare const recordMemoryWrite: (input: {
+    sessionId?: string;
+    mode: "save" | "kg_add" | "diary_write";
+    scope?: MemoryScope;
+    room?: string;
+    preview: string;
+}) => Promise<void>;
+export declare const recordAutosave: (input: {
+    sessionId: string;
+    outcome: StatusAutosaveOutcome;
+    reason: string;
+    wing?: string;
+    sourcePreview?: string;
+}) => Promise<void>;
+export declare const readStatusState: () => Promise<StatusState>;
+export declare const resetStatusState: () => Promise<void>;
+export declare const formatSessionHud: (state: StatusState, sessionId: string) => string;
+export declare const formatStatusSummary: (state: StatusState, sessionId?: string, options?: {
+    verbose?: boolean;
+    compact?: boolean;
+}) => string;
+export {};