@echomem/mcp 1.4.7 → 1.4.9

package/dist/v1-contract.js

@@ -16,6 +16,7 @@ export const canonicalToolNames = {
     recompose: "echo_recompose",
     delete: "delete_memory",
     getByContext: "get_memories_by_context",
+    checkpointByContext: "get_checkpoint_by_context",
 };
 export const legacyAliasToCanonical = {
     search_memories_by_description_semantic: canonicalToolNames.search,
@@ -114,7 +115,7 @@ export function listToolSpecs(opts = {}) {
     return [
         {
             name: canonicalToolNames.search,
-            description: withMcpVersion(`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}.${updateSection}`),
+            description: withMcpVersion(`Recall the user's prior decisions, preferences, and project context from EchoMem — their long-term memory across ALL their AI tools, not just this session. Use it instead of re-deriving or re-asking what the user already settled.${mapSection}\nReturns the ranked memories; set includeAnswer=true only if you need the legacy synthesized answer. Current time: ${currentTime}.${updateSection}`),
             inputSchema: {
                 type: "object",
                 properties: {
@@ -160,7 +161,7 @@ export function listToolSpecs(opts = {}) {
         },
         {
             name: canonicalToolNames.save,
-            description: "Save conversation into EchoMem for future retrieval. Set passthrough=true to store the text verbatim as a session capsule (no LLM extraction, no embeddings) — use this for warm-up capsules that a fresh session will reload via get_memories_by_context.",
+            description: "Save this conversation into EchoMem as long-term memory (durable memories are extracted automatically). passthrough=true stores the text verbatim as a session capsule instead — reload it later via get_memories_by_context.",
             inputSchema: {
                 type: "object",
                 properties: {
@@ -383,6 +384,23 @@ export function listToolSpecs(opts = {}) {
                 required: ["contextId"],
             },
         },
+        {
+            name: canonicalToolNames.checkpointByContext,
+            description: withMcpVersion(`Rebuild a clean-context checkpoint / decision log from one EchoMem contextId. Use this when the user or EchoMem HUD gives you a contextId for a renewed coding session and you need the session handoff, not a raw memory dump. It deterministically fetches that context and formats it as orientation state: decisions, carryover, constraints, and checkpoints. Current time: ${currentTime}.`),
+            inputSchema: {
+                type: "object",
+                properties: {
+                    contextId: { type: "string", description: "The EchoMem contextId shown by the HUD or returned by save_conversation / Renew session." },
+                    limit: { type: "number", default: 100 },
+                    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: ["contextId"],
+            },
+        },
         {
             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,7 +1,7 @@
 {
   "name": "@echomem/mcp",
-  "version": "1.4.7",
-  "description": "EchoMem Cloud-First MCP Server",
+  "version": "1.4.9",
+  "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",
   "bin": {
@@ -18,9 +18,11 @@
   "scripts": {
     "build": "tsc",
     "start": "node dist/index.js",
-    "dev": "tsx src/index.ts",
+    "predev": "npm run build",
+    "dev": "node dist/index.js",
     "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/update-check.test.mjs && node test/delete.test.mjs && node test/migrate.test.mjs && node test/hud.test.mjs",
+    "preview:extraction": "npm run build && node scripts/preview-extraction.mjs",
+    "test": "npm run build && node test/local-data-paths.test.mjs && node test/crypto.test.mjs && node test/integration.test.mjs && node test/no-restart.test.mjs && node test/report.test.mjs && node test/forensics.test.mjs && node test/canonical-golden.test.mjs && node test/tools.test.mjs && node test/update-check.test.mjs && node test/delete.test.mjs && node test/low-touch-tools.test.mjs && node test/migrate.test.mjs && node test/hud.test.mjs",
     "prepack": "npm run build && node scripts/bundle-city.mjs"
   },
   "dependencies": {

package/templates/echomem-recall.md

@@ -1,5 +1,5 @@
-<!-- echomem:recall-rule v1 — installed by `npx @echomem/mcp setup` into the client's
-     project rules (CLAUDE.md / .cursor/rules / AGENTS.md). This is the second half of the
+<!-- echomem:recall-rule v1 — installed by `echomem-mcp init` / `echomem-mcp setup` into the client's
+     global agent guidance (CLAUDE.md / AGENTS.md). This is the second half of the
      nudged-triggering design (spec §9): the tool description nudges, this rule reinforces. -->
 
 ## EchoMem memory