@echomem/mcp 1.2.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,14 +15,21 @@ 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(),
     threshold: z.number().optional().default(0.1),
     timeFrameDays: z.number().optional(),
+    includeAnswer: z.boolean().optional().default(false),
 });
 export const saveConversationSchema = z.object({
+    ...triggerMetadataSchema,
     conversation: z.string().optional(),
     title: z.string().optional(),
     url: z.string().optional(),
@@ -35,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();
@@ -55,7 +71,7 @@ export function listToolSpecs(opts = {}) {
     return [
         {
             name: canonicalToolNames.search,
-            description: `Recall the user's prior decisions, preferences, constraints, and project context from EchoMem — their long-term memory across ALL their AI tools (Claude.ai, ChatGPT, other agents), not just this session.${mapSection}\nCall this when the task plausibly relates to that remembered context — a topic above, or when the user refers to past work ("what did we decide", "like before", "the usual") — so you don't re-derive or re-ask what they already settled. Skip it for self-contained tasks with no link to their history (e.g. a generic algorithm question). Returns ranked memories with provenance. Current time: ${currentTime}.`,
+            description: `Recall the user's prior decisions, preferences, constraints, and project context from EchoMem — their long-term memory across ALL their AI tools (Claude.ai, ChatGPT, other agents), not just this session.${mapSection}\nCall this when the task plausibly relates to that remembered context — a topic above, or when the user refers to past work ("what did we decide", "like before", "the usual") — so you don't re-derive or re-ask what they already settled. Skip it for self-contained tasks with no link to their history (e.g. a generic algorithm question). By default this returns only the ranked memories retrieved for recall and skips EchoMem answer generation; set includeAnswer=true only when you explicitly need EchoMem's legacy synthesized recall. Current time: ${currentTime}.`,
             inputSchema: {
                 type: "object",
                 properties: {
@@ -63,6 +79,16 @@ export function listToolSpecs(opts = {}) {
                     limit: { type: "number", default: 10 },
                     threshold: { type: "number", default: 0.1 },
                     timeFrameDays: { type: "number" },
+                    includeAnswer: {
+                        type: "boolean",
+                        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" },
                 },
             },
         },
@@ -76,6 +102,16 @@ export function listToolSpecs(opts = {}) {
                     limit: { type: "number", default: 10 },
                     threshold: { type: "number", default: 0.1 },
                     timeFrameDays: { type: "number" },
+                    includeAnswer: {
+                        type: "boolean",
+                        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" },
                 },
             },
         },
@@ -100,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" },
                 },
             },
         },
@@ -112,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"],
             },
@@ -124,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"],
             },
@@ -135,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.2.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",
+    "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": {