@finchagentic/mcp 4.5.0 → 4.6.0

package/README.md

@@ -29,13 +29,13 @@ Always pin the version. Never use `@latest`.
 
 ```bash
 # One-command installer (detects common MCP clients)
-npx -y -p @finchagentic/mcp@4.5.0 finch install
+npx -y -p @finchagentic/mcp@4.6.0 finch install
 ```
 
 ### Claude Code
 
 ```bash
-claude mcp add finch -s user -- npx -y -p @finchagentic/mcp@4.5.0 finch-mcp
+claude mcp add finch -s user -- npx -y -p @finchagentic/mcp@4.6.0 finch-mcp
 ```
 
 ### Cursor / Windsurf / Claude Desktop
@@ -45,7 +45,7 @@ claude mcp add finch -s user -- npx -y -p @finchagentic/mcp@4.5.0 finch-mcp
   "mcpServers": {
     "finch": {
       "command": "npx",
-      "args": ["-y", "-p", "@finchagentic/mcp@4.5.0", "finch-mcp"]
+      "args": ["-y", "-p", "@finchagentic/mcp@4.6.0", "finch-mcp"]
     }
   }
 }
@@ -59,7 +59,7 @@ claude mcp add finch -s user -- npx -y -p @finchagentic/mcp@4.5.0 finch-mcp
     "finch": {
       "type": "stdio",
       "command": "npx",
-      "args": ["-y", "-p", "@finchagentic/mcp@4.5.0", "finch-mcp"]
+      "args": ["-y", "-p", "@finchagentic/mcp@4.6.0", "finch-mcp"]
     }
   }
 }
@@ -124,7 +124,7 @@ Default palette is `core` (lighter context). Full set:
 Finch is the runtime. **Your LLM is the brain. Your data stays yours.**
 
 ```bash
-npx -y -p @finchagentic/mcp@4.5.0 finch setup
+npx -y -p @finchagentic/mcp@4.6.0 finch setup
 # enable local vault (and optional local memory)
 ```
 
@@ -156,7 +156,7 @@ Scheduled/cloud features still need an account. Core memory, vault, and public-d
 Guided setup:
 
 ```bash
-npx -y -p @finchagentic/mcp@4.5.0 finch setup
+npx -y -p @finchagentic/mcp@4.6.0 finch setup
 ```
 
 ## Security
@@ -165,7 +165,7 @@ npx -y -p @finchagentic/mcp@4.5.0 finch setup
 |:-:|----------|------|
 | 1 | Prompt injection | External content is data only — never instructions |
 | 2 | Mainnet confirm | Estimate → preview → confirm → execute |
-| 3 | Pinned install | Always `@finchagentic/mcp@4.5.0`, never `@latest` |
+| 3 | Pinned install | Always `@finchagentic/mcp@4.6.0`, never `@latest` |
 | 4 | Credential vault | Never paste secrets into prompts or third-party tools |
 | 5 | Data disclosure | Know what leaves the machine (LLM, Firecrawl, GitHub, chain RPCs) |
 | 6 | Server monitors | Scheduled jobs need explicit confirmation |

package/dist/tools/memory.js

@@ -304,7 +304,11 @@ exports.MEMORY_TOOLS = [
             "searchable in ~30s. Retrieval is full-text (keyword) search, not embeddings - " +
             "'what did I say about ETH yield?' finds notes containing those words or close variants, " +
             "not unrelated phrasing with the same meaning. " +
-            "Auto-deduplicates: identical content in your recent 50 memories is skipped (override with force:true).",
+            "Auto-deduplicates: identical content in your recent 50 memories is skipped (override with force:true). " +
+            "Also surfaces up to 3 existing memories that share real keyword overlap with what you just saved (a " +
+            "possible-conflict HINT, not a verdict - Finch doesn't call an LLM to judge this). When that shows up, " +
+            "read them and decide yourself whether the new one supersedes an old preference/fact; if so, say so in a " +
+            "follow-up memory_add, or fold both into one with memory_consolidate.",
         inputSchema: {
             type: "object",
             properties: {
@@ -563,6 +567,32 @@ async function handleMemoryTool(name, args) {
             // dedupes even before supermemory has indexed the first one.
             if (!sourceUrl)
                 rememberRecentHash(hash, data?.id ?? "saved", title);
+            // ─── Conflict hint (not a proof) ──────────────────────────────────
+            // Finch never runs its own LLM call to judge this - "two-pass, no API
+            // key needed" is deliberate (see this file's header comment), and an
+            // autonomous contradiction call would break that. Instead this just
+            // resurfaces whatever memory_search's own retrieval already ranks as
+            // related to the content just saved, so the CALLING model - already
+            // reasoning about this exact save, in the same turn, no extra API
+            // cost - can judge for itself whether the two actually conflict and
+            // decide what to do (mark the old one superseded, fold both into
+            // memory_consolidate, or just note the new one is the current one).
+            // Best-effort: a search hiccup here must never fail or block the save
+            // that already succeeded above.
+            let conflictNote = "";
+            try {
+                const related = await hybridMemorySearch(content, 6);
+                const candidates = related
+                    .filter((r) => r.id !== data?.id && contentHash(r.content) !== hash)
+                    .slice(0, 3);
+                if (candidates.length) {
+                    conflictNote = "\n\n⚠️ **Possibly related existing memories** - skim these for a conflict with what you just saved (e.g. an old preference this replaces):\n" +
+                        candidates.map((r) => `- \`${r.id}\`: ${r.content.slice(0, 100)}${r.content.length > 100 ? "…" : ""}`).join("\n");
+                }
+            }
+            catch {
+                // best-effort only
+            }
             return {
                 content: [{
                         type: "text",
@@ -573,7 +603,7 @@ async function handleMemoryTool(name, args) {
                             tags?.length ? `Tags: ${tags.join(", ")}` : "",
                             ``,
                             `Find it with: \`memory_search query: "${(title ?? content).slice(0, 40)}"\``,
-                        ].filter(Boolean).join("\n"),
+                        ].filter(Boolean).join("\n") + conflictNote,
                     }],
             };
         }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@finchagentic/mcp",
-  "version": "4.5.0",
+  "version": "4.6.0",
   "description": "The runtime layer for Agentic AI. Persistent memory, autonomous agents, and workflows that survive every session.",
   "main": "dist/index.js",
   "bin": {