@echomem/mcp 1.4.12 → 1.4.14

package/dist/index.js

@@ -467,11 +467,11 @@ class EchoMemApiClient {
     getSessionId() {
         return this.sessionId;
     }
-    async trackMcpAnalyticsEvent(eventType, eventProperties) {
+    async trackMcpAnalyticsEvent(eventType, eventProperties, insertId) {
         if (!this.hasToken())
             return;
         try {
-            await this.axios.post("/api/extension/mcp/events", { eventType, eventProperties }, { timeout: 1500 });
+            await this.axios.post("/api/extension/mcp/events", { eventType, eventProperties, insertId }, { timeout: 1500 });
         }
         catch {
             // Remote analytics is best-effort and must never change MCP behavior.
@@ -575,6 +575,8 @@ class EchoMemApiClient {
             k: opts.limit,
             similarityThreshold: opts.threshold,
             timeFrameDays: opts.timeFrameDays,
+            requestId: opts.requestId,
+            sessionId: this.sessionId,
         });
         const data = enc.enabled ? await this.decryptResult(response.data, enc.key) : response.data;
         return retrievalOnly && isRecord(data)
@@ -584,6 +586,8 @@ class EchoMemApiClient {
     async searchMemoriesRetrieved(query, opts, enc) {
         const response = await this.axios.post("/api/extension/memories/deep-search/candidates", {
             query,
+            requestId: opts.requestId,
+            logicalRequestId: opts.requestId,
             sessionId: this.sessionId,
             userTimeZone: Intl.DateTimeFormat().resolvedOptions().timeZone || "UTC",
         });
@@ -644,9 +648,12 @@ class EchoMemApiClient {
     // never hits dg-web directly, so no new auth is needed and no other caller is
     // disrupted. NOTE: encrypted users still get server-side plaintext only; the
     // phase-1 + bridge-local-decrypt + phase-2 flow (spec §11) is the remaining work.
-    async searchMemoriesTuned(query) {
+    async searchMemoriesTuned(query, requestId) {
         const response = await this.axios.post("/api/extension/memories/deep-search", {
             query,
+            requestId,
+            logicalRequestId: requestId,
+            sessionId: this.sessionId,
             userTimeZone: Intl.DateTimeFormat().resolvedOptions().timeZone || "UTC",
         });
         const data = response.data ?? {};
@@ -681,27 +688,24 @@ class EchoMemApiClient {
             });
             return enc.enabled ? await this.decryptResult(response.data, enc.key) : response.data;
         }
-        const searchOpts = { limit, threshold, timeFrameDays: parsed.timeFrameDays };
+        const searchOpts = {
+            limit,
+            threshold,
+            timeFrameDays: parsed.timeFrameDays,
+            requestId: randomUUID(),
+        };
         if (!parsed.includeAnswer) {
-            try {
-                return await this.searchMemoriesRetrieved(query, searchOpts, enc);
-            }
-            catch {
-                return await this.searchMemoriesRaw(query, searchOpts, enc, true);
-            }
+            return this.searchMemoriesRetrieved(query, searchOpts, enc);
         }
         // Encrypted account: the server can't synthesize over plaintext it doesn't hold, so use the raw
         // retriever (returns ciphertext) and decrypt locally — zero-knowledge preserved end-to-end.
         if (enc.enabled) {
             return await this.searchMemoriesRaw(query, searchOpts, enc);
         }
-        // Unencrypted: prefer the tuned two-phase retriever; degrade gracefully to the untuned path.
-        try {
-            return await this.searchMemoriesTuned(query);
-        }
-        catch {
-            return await this.searchMemoriesRaw(query, searchOpts, enc);
-        }
+        // A synthesized answer is metered through the legacy route. Do not fall
+        // back to raw retrieval after a ledger outage: that would return a result
+        // without a durable usage fact.
+        return this.searchMemoriesTuned(query, searchOpts.requestId);
     }
     /** Decrypt the model-visible fields on a `{ memories: [...] }` response locally. */
     async decryptResult(data, key) {
@@ -970,6 +974,7 @@ class EchoMemMCPServer {
                 ...triggerAnalyticsForTool(canonicalName, request.params.arguments),
                 ...inputAnalyticsForTool(canonicalName, request.params.arguments),
             };
+            const analyticsCallId = randomUUID();
             // One event per call. Handlers enrich `rec` with tool-specific detail; we finalize + log in `finally`.
             const rec = {
                 type: "tool_call",
@@ -1029,8 +1034,8 @@ class EchoMemMCPServer {
                 if (!this.client.hasToken())
                     throw new NoTokenError();
                 if (canonicalName !== canonicalToolNames.save) {
-                    void this.client.trackMcpAnalyticsEvent("[MCP] EchoMem Tool Called", analyticsBase);
-                    void this.client.trackMcpAnalyticsEvent(toolEventName(canonicalName, "Called"), analyticsBase);
+                    void this.client.trackMcpAnalyticsEvent("[MCP] EchoMem Tool Called", analyticsBase, `${analyticsCallId}:generic-called`);
+                    void this.client.trackMcpAnalyticsEvent(toolEventName(canonicalName, "Called"), analyticsBase, `${analyticsCallId}:called`);
                 }
                 if (canonicalName !== canonicalToolNames.save && analyticsBase.trigger_message_available === true) {
                     void this.client.trackMcpAnalyticsEvent("[MCP] EchoMem Triggered By User Turn", analyticsBase);
@@ -1125,8 +1130,8 @@ class EchoMemMCPServer {
                         encrypted_user: rec.encrypted,
                         extracted_memory_count: rec.memories_extracted,
                     };
-                    void this.client.trackMcpAnalyticsEvent(rec.ok ? "[MCP] EchoMem Tool Succeeded" : "[MCP] EchoMem Tool Failed", finalAnalytics);
-                    void this.client.trackMcpAnalyticsEvent(toolEventName(canonicalName, rec.ok ? "Succeeded" : "Failed"), finalAnalytics);
+                    void this.client.trackMcpAnalyticsEvent(rec.ok ? "[MCP] EchoMem Tool Succeeded" : "[MCP] EchoMem Tool Failed", finalAnalytics, `${analyticsCallId}:generic-completed`);
+                    void this.client.trackMcpAnalyticsEvent(toolEventName(canonicalName, rec.ok ? "Succeeded" : "Failed"), finalAnalytics, `${analyticsCallId}:completed`);
                 }
             }
         });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@echomem/mcp",
-  "version": "1.4.12",
+  "version": "1.4.14",
   "description": "EchoMem MCP bridge: cloud-first memory tools, local context HUD, and the Agent Doctor workspace forensics report (cost ledger + 3D repo city)",
   "main": "dist/index.js",
   "type": "module",