@echomem/mcp 1.3.0 → 1.3.1

package/dist/v1-contract.js

@@ -6,6 +6,7 @@ export const canonicalToolNames = {
     keywords: "search_memories_by_keywords",
     others: "search_others_memories",
     report: "echomem_usage_report",
+    delete: "delete_memory",
 };
 export const legacyAliasToCanonical = {
     search_memories_by_description_semantic: canonicalToolNames.search,
@@ -14,7 +15,12 @@ export const legacyAliasToCanonical = {
 export function resolveCanonicalToolName(toolName) {
     return legacyAliasToCanonical[toolName] ?? toolName;
 }
+const triggerMetadataSchema = {
+    triggerMessage: z.string().optional(),
+    triggerMessageRole: z.string().optional(),
+};
 export const searchMemoriesSchema = z.object({
+    ...triggerMetadataSchema,
     query: z.string().optional(),
     k: z.number().optional(),
     limit: z.number().optional(),
@@ -23,6 +29,7 @@ export const searchMemoriesSchema = z.object({
     includeAnswer: z.boolean().optional().default(false),
 });
 export const saveConversationSchema = z.object({
+    ...triggerMetadataSchema,
     conversation: z.string().optional(),
     title: z.string().optional(),
     url: z.string().optional(),
@@ -36,17 +43,25 @@ export const saveConversationSchema = z.object({
         .optional(),
 });
 export const timeRangeSchema = z.object({
+    ...triggerMetadataSchema,
     startDate: z.string(),
     endDate: z.string(),
     limit: z.number().optional().default(50),
 });
 export const keywordsSchema = z.object({
+    ...triggerMetadataSchema,
     keywords: z.array(z.string()),
     limit: z.number().optional().default(10),
 });
 export const othersSchema = z.object({
+    ...triggerMetadataSchema,
     query: z.string(),
 });
+export const deleteMemorySchema = z.object({
+    memoryId: z.string().min(1),
+    confirmed: z.boolean().optional().default(false),
+    confirmationToken: z.string().optional(),
+});
 export function listToolSpecs(opts = {}) {
     const currentTime = new Date().toISOString();
     const map = opts.map?.trim();
@@ -69,6 +84,11 @@ export function listToolSpecs(opts = {}) {
                         default: false,
                         description: "Default false: return only retrieved memories and skip answer generation. Set true for the legacy synthesized recall answer.",
                     },
+                    triggerMessage: {
+                        type: "string",
+                        description: "Optional: the user's message that caused this recall. EchoMem stores only a redacted analytics preview and hash.",
+                    },
+                    triggerMessageRole: { type: "string", default: "user" },
                 },
             },
         },
@@ -87,6 +107,11 @@ export function listToolSpecs(opts = {}) {
                         default: false,
                         description: "Default false: return only retrieved memories and skip answer generation. Set true for the legacy synthesized recall answer.",
                     },
+                    triggerMessage: {
+                        type: "string",
+                        description: "Optional: the user's message that caused this recall. EchoMem stores only a redacted analytics preview and hash.",
+                    },
+                    triggerMessageRole: { type: "string", default: "user" },
                 },
             },
         },
@@ -111,6 +136,11 @@ export function listToolSpecs(opts = {}) {
                             },
                         },
                     },
+                    triggerMessage: {
+                        type: "string",
+                        description: "Optional: the user's message that caused this save. EchoMem stores only a redacted analytics preview and hash.",
+                    },
+                    triggerMessageRole: { type: "string", default: "user" },
                 },
             },
         },
@@ -123,6 +153,11 @@ export function listToolSpecs(opts = {}) {
                     startDate: { type: "string" },
                     endDate: { type: "string" },
                     limit: { type: "number", default: 50 },
+                    triggerMessage: {
+                        type: "string",
+                        description: "Optional: the user's message that caused this lookup. EchoMem stores only a redacted analytics preview and hash.",
+                    },
+                    triggerMessageRole: { type: "string", default: "user" },
                 },
                 required: ["startDate", "endDate"],
             },
@@ -135,6 +170,11 @@ export function listToolSpecs(opts = {}) {
                 properties: {
                     keywords: { type: "array", items: { type: "string" } },
                     limit: { type: "number", default: 10 },
+                    triggerMessage: {
+                        type: "string",
+                        description: "Optional: the user's message that caused this keyword search. EchoMem stores only a redacted analytics preview and hash.",
+                    },
+                    triggerMessageRole: { type: "string", default: "user" },
                 },
                 required: ["keywords"],
             },
@@ -146,10 +186,38 @@ export function listToolSpecs(opts = {}) {
                 type: "object",
                 properties: {
                     query: { type: "string" },
+                    triggerMessage: {
+                        type: "string",
+                        description: "Optional: the user's message that caused this public-memory search. EchoMem stores only a redacted analytics preview and hash.",
+                    },
+                    triggerMessageRole: { type: "string", default: "user" },
                 },
                 required: ["query"],
             },
         },
+        {
+            name: canonicalToolNames.delete,
+            description: "Delete one of the user's EchoMem memories only after explicit user confirmation. First call with memoryId and confirmed omitted/false to preview the target and receive a confirmationToken; this first call never deletes. Only call again with confirmed=true and that exact confirmationToken after the user explicitly confirms deletion. Deletes the memory row only; raw source_of_truth conversation records are preserved.",
+            inputSchema: {
+                type: "object",
+                properties: {
+                    memoryId: {
+                        type: "string",
+                        description: "The EchoMem memory id to delete.",
+                    },
+                    confirmed: {
+                        type: "boolean",
+                        default: false,
+                        description: "Leave false for the preview step. Set true only after the user explicitly confirms deletion.",
+                    },
+                    confirmationToken: {
+                        type: "string",
+                        description: "Required when confirmed=true. Use the exact token returned by the preview step.",
+                    },
+                },
+                required: ["memoryId"],
+            },
+        },
         {
             name: canonicalToolNames.report,
             description: "Show the user a one-screen audit of THEIR OWN AI coding usage — computed locally from their Codex/Claude Code logs ($0, nothing uploaded): how many tokens their agents spent, how much was re-reading context, reads vs memory recalls, and what changes with EchoMem. Call this when the user asks about their usage, token spend, cost, how much they're wasting, or wants a summary of their agent activity — and you may offer it once right after EchoMem is first connected. Returns formatted text to show the user verbatim. Needs no login.",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@echomem/mcp",
-  "version": "1.3.0",
+  "version": "1.3.1",
   "description": "EchoMem Cloud-First MCP Server",
   "main": "dist/index.js",
   "type": "module",
@@ -17,7 +17,7 @@
     "start": "node dist/index.js",
     "dev": "tsx src/index.ts",
     "smoke": "node smoke.mjs",
-    "test": "npm run build && node test/crypto.test.mjs && node test/integration.test.mjs && node test/no-restart.test.mjs && node test/report.test.mjs && node test/tools.test.mjs && node test/migrate.test.mjs",
+    "test": "npm run build && node test/crypto.test.mjs && node test/integration.test.mjs && node test/no-restart.test.mjs && node test/report.test.mjs && node test/tools.test.mjs && node test/delete.test.mjs && node test/migrate.test.mjs",
     "prepack": "npm run build"
   },
   "dependencies": {