@rvboris/opencode-mempalace 0.3.0 → 0.5.0

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

@@ -7,10 +7,18 @@ export type MemoryScope = (typeof MEMORY_SCOPES)[number];
 export declare const USER_MEMORY_ROOMS: readonly ["preferences", "workflow", "communication"];
 export declare const PROJECT_MEMORY_ROOMS: readonly ["architecture", "workflow", "decisions", "bugs", "setup"];
 export type KnownMemoryRoom = (typeof USER_MEMORY_ROOMS)[number] | (typeof PROJECT_MEMORY_ROOMS)[number];
-export declare const TOOL_MEMORY_MODES: readonly ["save", "search", "kg_add", "diary_write"];
+export declare const TOOL_MEMORY_MODES: readonly ["save", "search", "kg_add", "diary_write", "delete", "delete_by_source", "kg_query", "diary_read", "checkpoint"];
 export type ToolMemoryMode = (typeof TOOL_MEMORY_MODES)[number];
-export declare const ADAPTER_MODES: readonly ["save", "search", "kg_add", "diary_write", "mine_messages"];
+export declare const ADAPTER_MODES: readonly ["save", "search", "kg_add", "diary_write", "mine_messages", "delete", "delete_by_source", "kg_query", "diary_read", "checkpoint"];
 export type AdapterMode = (typeof ADAPTER_MODES)[number];
+export type RetrievalVerdict = "none" | "cited" | "improved" | "saved-time" | "unknown";
+export type RetrievalJudgeCounters = {
+    none: number;
+    cited: number;
+    improved: number;
+    savedTime: number;
+    unknown: number;
+};
 export declare const SESSION_EVENT_TYPES: readonly ["session.idle", "session.compacted", "session.deleted", "session.error", "session.updated", "message.updated"];
 export type SessionEventType = (typeof SESSION_EVENT_TYPES)[number];
 export type AppLogLevel = "info" | "warn" | "error";
@@ -49,6 +57,7 @@ export type SearchAdapterRequest = {
     wing: string;
     room?: string;
     limit?: number;
+    source_file?: string;
 };
 export type KgAddAdapterRequest = {
     mode: "kg_add";
@@ -70,8 +79,47 @@ export type MineMessagesAdapterRequest = {
     wing: string;
     extract_mode: string;
     agent: string;
+    palace_path?: string;
+};
+export type DeleteAdapterRequest = {
+    mode: "delete";
+    drawer_id: string;
+};
+export type DeleteBySourceAdapterRequest = {
+    mode: "delete_by_source";
+    source_file: string;
+    dry_run: boolean;
+};
+export type KgQueryAdapterRequest = {
+    mode: "kg_query";
+    entity: string;
+    as_of?: string;
+    direction?: string;
+};
+export type DiaryReadAdapterRequest = {
+    mode: "diary_read";
+    agent_name?: string;
+    last_n?: number;
+    wing?: string;
+};
+export type CheckpointItem = {
+    wing: string;
+    room: string;
+    content: string;
+};
+export type CheckpointDiary = {
+    agent_name?: string;
+    entry: string;
+    topic?: string;
+    wing?: string;
+};
+export type CheckpointAdapterRequest = {
+    mode: "checkpoint";
+    items: CheckpointItem[];
+    diary?: CheckpointDiary;
+    dedup_threshold?: number;
 };
-export type AdapterRequest = SaveAdapterRequest | SearchAdapterRequest | KgAddAdapterRequest | DiaryWriteAdapterRequest | MineMessagesAdapterRequest;
+export type AdapterRequest = SaveAdapterRequest | SearchAdapterRequest | KgAddAdapterRequest | DiaryWriteAdapterRequest | MineMessagesAdapterRequest | DeleteAdapterRequest | DeleteBySourceAdapterRequest | KgQueryAdapterRequest | DiaryReadAdapterRequest | CheckpointAdapterRequest;
 export type AdapterResponse = {
     success?: boolean;
     error?: string;

package/dist/plugin/lib/types.js

@@ -3,8 +3,8 @@ export { DEFAULT_ROOM, DEFAULT_TOPIC, DEFAULT_AGENT_NAME, DEFAULT_EXTRACT_MODE,
 export const MEMORY_SCOPES = ["user", "project"];
 export const USER_MEMORY_ROOMS = ["preferences", "workflow", "communication"];
 export const PROJECT_MEMORY_ROOMS = ["architecture", "workflow", "decisions", "bugs", "setup"];
-export const TOOL_MEMORY_MODES = ["save", "search", "kg_add", "diary_write"];
-export const ADAPTER_MODES = ["save", "search", "kg_add", "diary_write", "mine_messages"];
+export const TOOL_MEMORY_MODES = ["save", "search", "kg_add", "diary_write", "delete", "delete_by_source", "kg_query", "diary_read", "checkpoint"];
+export const ADAPTER_MODES = ["save", "search", "kg_add", "diary_write", "mine_messages", "delete", "delete_by_source", "kg_query", "diary_read", "checkpoint"];
 export const SESSION_EVENT_TYPES = [
     "session.idle",
     "session.compacted",

package/dist/plugin/tools/mempalace-memory.d.ts

@@ -7,6 +7,11 @@ export declare const mempalaceMemoryTool: (ctx: ToolContext) => {
             search: "search";
             kg_add: "kg_add";
             diary_write: "diary_write";
+            delete: "delete";
+            delete_by_source: "delete_by_source";
+            kg_query: "kg_query";
+            diary_read: "diary_read";
+            checkpoint: "checkpoint";
         }>;
         scope: import("zod").ZodDefault<import("zod").ZodOptional<import("zod").ZodEnum<{
             user: "user";
@@ -21,18 +26,42 @@ export declare const mempalaceMemoryTool: (ctx: ToolContext) => {
         topic: import("zod").ZodDefault<import("zod").ZodOptional<import("zod").ZodString>>;
         agent_name: import("zod").ZodDefault<import("zod").ZodOptional<import("zod").ZodString>>;
         limit: import("zod").ZodDefault<import("zod").ZodOptional<import("zod").ZodNumber>>;
+        source_file: import("zod").ZodOptional<import("zod").ZodString>;
+        drawer_id: import("zod").ZodOptional<import("zod").ZodString>;
+        entity: import("zod").ZodOptional<import("zod").ZodString>;
+        as_of: import("zod").ZodOptional<import("zod").ZodString>;
+        direction: import("zod").ZodDefault<import("zod").ZodOptional<import("zod").ZodEnum<{
+            outgoing: "outgoing";
+            incoming: "incoming";
+            both: "both";
+        }>>>;
+        dry_run: import("zod").ZodDefault<import("zod").ZodOptional<import("zod").ZodBoolean>>;
+        last_n: import("zod").ZodDefault<import("zod").ZodOptional<import("zod").ZodNumber>>;
+        items: import("zod").ZodOptional<import("zod").ZodString>;
+        diary: import("zod").ZodOptional<import("zod").ZodString>;
+        dedup_threshold: import("zod").ZodDefault<import("zod").ZodOptional<import("zod").ZodNumber>>;
     };
     execute(args: {
-        mode: "save" | "search" | "kg_add" | "diary_write";
+        mode: "save" | "search" | "kg_add" | "diary_write" | "delete" | "delete_by_source" | "kg_query" | "diary_read" | "checkpoint";
         scope: "user" | "project";
         room: string;
         topic: string;
         agent_name: string;
         limit: number;
+        direction: "outgoing" | "incoming" | "both";
+        dry_run: boolean;
+        last_n: number;
+        dedup_threshold: number;
         content?: string | undefined;
         query?: string | undefined;
         subject?: string | undefined;
         predicate?: string | undefined;
         object?: string | undefined;
+        source_file?: string | undefined;
+        drawer_id?: string | undefined;
+        entity?: string | undefined;
+        as_of?: string | undefined;
+        items?: string | undefined;
+        diary?: string | undefined;
     }, context: import("@opencode-ai/plugin").ToolContext): Promise<string>;
 };

package/dist/plugin/tools/mempalace-memory.js

@@ -2,11 +2,12 @@ import { tool } from "@opencode-ai/plugin";
 import { executeAdapter } from "../lib/adapter";
 import { loadConfig } from "../lib/config";
 import { sanitizeText } from "../lib/derive";
-import { DATE_ISO_SLICE, DEFAULT_AGENT_NAME, DEFAULT_LIMIT, DEFAULT_ROOM, DEFAULT_TOPIC, ERROR_MESSAGES, TOOL_DESCRIPTIONS } from "../lib/constants";
+import { DATE_ISO_SLICE, DEFAULT_AGENT_NAME, DEFAULT_LIMIT, DEFAULT_ROOM, DEFAULT_TOPIC, ERROR_MESSAGES, LOG_MESSAGES, TOOL_DESCRIPTIONS } from "../lib/constants";
 import { getProjectName } from "../lib/opencode";
 import { isFullyPrivate, redactSecrets } from "../lib/privacy";
 import { getProjectScope, getUserScope } from "../lib/scope";
-import { recordMemoryWrite, recordRetrievalSearch } from "../lib/status";
+import { recordMemoryWrite, recordRetrievalSearch, summarizeSearchResult } from "../lib/status";
+import { writeLog } from "../lib/log";
 import { MEMORY_SCOPES, TOOL_MEMORY_MODES } from "../lib/types";
 const getProjectWing = (projectName, prefix) => {
     return getProjectScope(projectName, prefix).wing;
@@ -34,6 +35,16 @@ export const mempalaceMemoryTool = (ctx) => tool({
         topic: tool.schema.string().optional().default(DEFAULT_TOPIC),
         agent_name: tool.schema.string().optional().default(DEFAULT_AGENT_NAME),
         limit: tool.schema.number().optional().default(DEFAULT_LIMIT),
+        source_file: tool.schema.string().optional(),
+        drawer_id: tool.schema.string().optional(),
+        entity: tool.schema.string().optional(),
+        as_of: tool.schema.string().optional(),
+        direction: tool.schema.enum(["outgoing", "incoming", "both"]).optional().default("both"),
+        dry_run: tool.schema.boolean().optional().default(true),
+        last_n: tool.schema.number().optional().default(10),
+        items: tool.schema.string().optional(),
+        diary: tool.schema.string().optional(),
+        dedup_threshold: tool.schema.number().optional().default(0.9),
     },
     async execute(args, executionContext) {
         const config = await loadConfig();
@@ -76,7 +87,9 @@ export const mempalaceMemoryTool = (ctx) => tool({
                 wing,
                 room: normalizeValue(args.room, false),
                 limit: args.limit,
+                source_file: args.source_file,
             });
+            const summary = summarizeSearchResult(result);
             if (result?.success !== false) {
                 await recordRetrievalSearch({
                     sessionId: executionContext.sessionID,
@@ -85,8 +98,22 @@ export const mempalaceMemoryTool = (ctx) => tool({
                     query,
                     result,
                 });
+                await writeLog("INFO", LOG_MESSAGES.retrievalSearchCompleted, {
+                    sessionId: executionContext.sessionID,
+                    scope,
+                    room: args.room,
+                    query: query.slice(0, 200),
+                    resultCount: summary.resultCount ?? 0,
+                    previews: summary.previews,
+                });
             }
-            return JSON.stringify(result);
+            const retrievalNote = summary.resultCount
+                ? `Found ${summary.resultCount} relevant ${summary.resultCount === 1 ? "memory" : "memories"}:\n${summary.previews.map((p, i) => `${i + 1}. ${p}`).join("\n")}`
+                : "No relevant memories found.";
+            const enriched = typeof result === "object" && result !== null
+                ? { ...result, _retrieval_summary: retrievalNote }
+                : result;
+            return JSON.stringify(enriched);
         }
         if (args.mode === "kg_add") {
             if (!args.subject || !args.predicate || !args.object) {
@@ -113,6 +140,75 @@ export const mempalaceMemoryTool = (ctx) => tool({
             }
             return JSON.stringify(result);
         }
+        if (args.mode === "delete") {
+            if (!args.drawer_id)
+                return JSON.stringify({ success: false, error: "drawer_id is required" });
+            const result = await executeAdapter(ctx.$, {
+                mode: "delete",
+                drawer_id: args.drawer_id,
+            });
+            return JSON.stringify(result);
+        }
+        if (args.mode === "delete_by_source") {
+            if (!args.source_file)
+                return JSON.stringify({ success: false, error: "source_file is required" });
+            const result = await executeAdapter(ctx.$, {
+                mode: "delete_by_source",
+                source_file: args.source_file,
+                dry_run: args.dry_run ?? true,
+            });
+            return JSON.stringify(result);
+        }
+        if (args.mode === "kg_query") {
+            if (!args.entity)
+                return JSON.stringify({ success: false, error: "entity is required" });
+            const result = await executeAdapter(ctx.$, {
+                mode: "kg_query",
+                entity: args.entity,
+                as_of: args.as_of,
+                direction: args.direction ?? "both",
+            });
+            return JSON.stringify(result);
+        }
+        if (args.mode === "diary_read") {
+            const result = await executeAdapter(ctx.$, {
+                mode: "diary_read",
+                agent_name: args.agent_name ?? DEFAULT_AGENT_NAME,
+                last_n: args.last_n ?? 10,
+                wing: scope === "user" ? getUserWing(config.userWingPrefix) : wing,
+            });
+            return JSON.stringify(result);
+        }
+        if (args.mode === "checkpoint") {
+            if (!args.items)
+                return JSON.stringify({ success: false, error: "items (JSON array) is required" });
+            let parsedItems;
+            let parsedDiary;
+            try {
+                parsedItems = JSON.parse(args.items);
+                if (args.diary)
+                    parsedDiary = JSON.parse(args.diary);
+            }
+            catch {
+                return JSON.stringify({ success: false, error: "items/diary must be valid JSON" });
+            }
+            const result = await executeAdapter(ctx.$, {
+                mode: "checkpoint",
+                items: parsedItems,
+                diary: parsedDiary,
+                dedup_threshold: args.dedup_threshold ?? 0.9,
+            });
+            if (result?.success !== false) {
+                await recordMemoryWrite({
+                    sessionId: executionContext.sessionID,
+                    mode: "save",
+                    scope,
+                    preview: `checkpoint: ${parsedItems.length} items`,
+                });
+            }
+            return JSON.stringify(result);
+        }
+        // Default: diary_write (fallthrough for mode === "diary_write")
         const result = await executeAdapter(ctx.$, {
             mode: "diary_write",
             agent_name: normalizeValue(args.agent_name, false) ?? DEFAULT_AGENT_NAME,

package/dist/plugin/tools/mempalace-status.js

@@ -4,7 +4,7 @@ import { formatStatusSummary, readStatusState } from "../lib/status";
 export const mempalaceStatusTool = () => tool({
     description: TOOL_DESCRIPTIONS.mempalaceStatus,
     args: {
-        verbose: tool.schema.boolean().optional().default(false),
+        verbose: tool.schema.boolean().optional().default(true),
         compact: tool.schema.boolean().optional().default(false),
     },
     async execute(args, executionContext) {

package/dist/plugin/tui/hud.js

@@ -7,7 +7,7 @@ const EMPTY_STATE = {
     counters: {
         retrievalPrompts: 0,
         retrievalSearches: 0,
-        retrievalHits: 0,
+        retrievalJudge: { none: 0, cited: 0, improved: 0, savedTime: 0, unknown: 0 },
         autosavesCompleted: 0,
         autosavesSkipped: 0,
         autosavesFailed: 0,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rvboris/opencode-mempalace",
-  "version": "0.3.0",
+  "version": "0.5.0",
   "description": "OpenCode plugin for hidden MemPalace retrieval and autosave via a local Python adapter.",
   "type": "module",
   "main": "dist/plugin/index.js",
@@ -57,8 +57,8 @@
     "lint": "biome lint plugin tests scripts package.json tsconfig.json example-opencode.json biome.json",
     "lint:ci": "biome lint plugin tests scripts package.json tsconfig.json example-opencode.json biome.json",
     "prepublishOnly": "npm run build",
-    "test": "bun test",
-    "test:coverage": "bun test --coverage --coverage-reporter=text --coverage-reporter=lcov",
+    "test": "bun test --parallel",
+    "test:coverage": "bun test --parallel --coverage --coverage-reporter=text --coverage-reporter=lcov",
     "typecheck": "tsc -p tsconfig.json --noEmit"
   },
   "publishConfig": {