@plur-ai/mcp 0.9.7 → 0.9.9

package/README.md

@@ -2,7 +2,7 @@
 
 Give your AI agent persistent memory. One line in your MCP config — corrections, preferences, and conventions persist across sessions. No workflow changes, no cloud, no API costs for search.
 
-Part of [PLUR](https://plur.ai) — where **Haiku with memory outperforms Opus without it** at 10x less cost.
+Part of [PLUR](https://plur.ai) — where, in our tool-routing and local-knowledge benchmark, **Haiku with memory outperformed Opus without it** at 10x less cost.
 
 ## Setup (30 seconds)
 

package/dist/index.js

@@ -5,7 +5,7 @@ import { existsSync, readFileSync, writeFileSync, mkdirSync, readdirSync, statSy
 import { join } from "path";
 import { fileURLToPath } from "url";
 import { homedir } from "os";
-var VERSION = "0.9.7";
+var VERSION = "0.9.9";
 var HELP = `plur-mcp v${VERSION} \u2014 persistent memory for AI agents
 
 Usage:
@@ -277,7 +277,7 @@ if (arg === "init") {
   process.exit(0);
 }
 if (arg === "serve" || arg === void 0) {
-  const { runStdio } = await import("./server-Y2KI6BN5.js");
+  const { runStdio } = await import("./server-X5ZMO46X.js");
   runStdio().catch((err) => {
     console.error("Failed to start PLUR MCP server:", err);
     process.exit(1);

package/dist/{server-Y2KI6BN5.js → server-X5ZMO46X.js}

@@ -15,6 +15,11 @@ import { Plur as Plur2, checkForUpdate } from "@plur-ai/core";
 
 // src/tools.ts
 import { extractMetaEngrams, validateMetaEngram, confidenceBand, generateProfile, getProfileForInjection, selectModelForOperation } from "@plur-ai/core";
+
+// src/version.ts
+var VERSION = "0.9.9";
+
+// src/tools.ts
 function makeHttpLlm(baseUrl, apiKey, model = "gpt-4o-mini") {
   return async (prompt) => {
     const response = await fetch(`${baseUrl.replace(/\/$/, "")}/chat/completions`, {
@@ -72,6 +77,15 @@ function getLlmFunction() {
   if (openaiKey) return makeHttpLlm("https://api.openai.com/v1", openaiKey, "gpt-4o-mini");
   return void 0;
 }
+function sanitizeStatement(raw) {
+  const markers = ["</statement>", "<parameter name="];
+  let cut = raw.length;
+  for (const m of markers) {
+    const pos = raw.indexOf(m);
+    if (pos !== -1 && pos < cut) cut = pos;
+  }
+  return raw.slice(0, cut).trimEnd();
+}
 function getToolDefinitions() {
   return [
     {
@@ -89,38 +103,12 @@ function getToolDefinitions() {
           },
           scope: { type: "string", description: "Namespace, e.g. global, project:myapp" },
           domain: { type: "string", description: "Domain tag, e.g. software.deployment" },
-          source: { type: "string", description: "Origin of this knowledge" },
-          tags: { type: "array", items: { type: "string" }, description: "Searchable keyword tags" },
-          rationale: { type: "string", description: "Why this knowledge matters" },
-          visibility: { type: "string", enum: ["private", "public", "template"], description: "Visibility level" },
-          knowledge_anchors: {
-            type: "array",
-            items: {
-              type: "object",
-              properties: {
-                path: { type: "string", description: "Path to related document" },
-                relevance: { type: "string", enum: ["primary", "supporting", "example"] },
-                snippet: { type: "string", description: "Short snippet (max 200 chars)" }
-              },
-              required: ["path"]
-            },
-            description: "Links to related knowledge documents"
-          },
-          dual_coding: {
-            type: "object",
-            properties: {
-              example: { type: "string", description: "Concrete example" },
-              analogy: { type: "string", description: "Analogy to aid understanding" }
-            },
-            description: "Dual coding for richer encoding"
-          },
-          abstract: { type: "string", description: "Abstract engram ID this was derived from" },
-          derived_from: { type: "string", description: "Source engram ID this was derived from" },
-          commitment: { type: "string", enum: ["exploring", "leaning", "decided", "locked"], description: "Commitment level (default: leaning)" },
-          locked_reason: { type: "string", description: "Reason for locking (when commitment=locked)" },
-          memory_class: { type: "string", enum: ["semantic", "episodic", "procedural", "metacognitive"], description: "Memory classification (auto-set from type if omitted)" },
-          session_episode_id: { type: "string", description: "Link to current session episode for episodic anchoring" },
-          pinned: { type: "boolean", description: "Always-load flag. If true, this engram bypasses the keyword-relevance gate and is eligible for injection on every session, regardless of overlap with the user task. Use sparingly: meta-rules, safety conventions, core operating principles only." }
+          tags: { type: "array", items: { type: "string" }, description: "Searchable keyword tags \u2014 contribute to BM25/embedding recall, so concrete keywords pay off" },
+          rationale: { type: "string", description: "Why this knowledge matters \u2014 also enters the search corpus, helps recall by intent not just statement" },
+          source: { type: "string", description: "Origin of this knowledge (URL, conversation ref, etc.)" },
+          pinned: { type: "boolean", description: "Always-load flag. If true, this engram bypasses the keyword-relevance gate at injection time. Use sparingly: meta-rules, safety conventions, core operating principles only." },
+          commitment: { type: "string", enum: ["exploring", "leaning", "decided", "locked"], description: "How firmly the user has committed to this belief (default: leaning)" },
+          locked_reason: { type: "string", description: "Why this engram is locked (only meaningful when commitment=locked)" }
         },
         required: ["statement"]
       },
@@ -133,33 +121,32 @@ function getToolDefinitions() {
           source: args.source,
           tags: args.tags,
           rationale: args.rationale,
-          visibility: args.visibility,
-          knowledge_anchors: args.knowledge_anchors,
-          dual_coding: args.dual_coding,
-          abstract: args.abstract,
-          derived_from: args.derived_from,
           commitment: args.commitment,
           locked_reason: args.locked_reason,
-          memory_class: args.memory_class,
-          session_episode_id: args.session_episode_id,
           pinned: args.pinned,
           llm
         };
+        const statement = sanitizeStatement(args.statement);
         try {
-          const result = await plur.learnAsync(args.statement, context);
+          const engram = await plur.learnRouted(statement, context);
           return {
-            id: result.engram.id,
-            statement: result.engram.statement,
-            scope: result.engram.scope,
-            type: result.engram.type,
-            pinned: result.engram.pinned === true,
-            decision: result.decision,
-            existing_id: result.existing_id,
-            tensions: result.tensions
+            id: engram.id,
+            statement: engram.statement,
+            scope: engram.scope,
+            type: engram.type,
+            pinned: engram.pinned === true,
+            decision: "ADD"
+          };
+        } catch (err) {
+          const engram = plur.learn(statement, context);
+          return {
+            id: engram.id,
+            statement: engram.statement,
+            scope: engram.scope,
+            type: engram.type,
+            decision: "ADD",
+            warning: `Remote write failed (${err.message}); fell back to local. The id above is the local placeholder \u2014 the canonical engram is NOT on the server.`
           };
-        } catch {
-          const engram = plur.learn(args.statement, context);
-          return { id: engram.id, statement: engram.statement, scope: engram.scope, type: engram.type, decision: "ADD" };
         }
       }
     },
@@ -174,7 +161,6 @@ function getToolDefinitions() {
           scope: { type: "string", description: "Filter by scope (also includes global)" },
           domain: { type: "string", description: "Filter by domain prefix" },
           limit: { type: "number", description: "Max results to return (default 20)" },
-          min_strength: { type: "number", description: "Minimum retrieval strength (0-1)" },
           budget: { type: "object", description: "Budget constraints for sub-agents", properties: { max_tokens: { type: "number" }, max_results: { type: "number" } } },
           caller_session_id: { type: "string", description: "Caller session ID for budget enforcement" }
         },
@@ -184,8 +170,7 @@ function getToolDefinitions() {
         const results = plur.recall(args.query, {
           scope: args.scope,
           domain: args.domain,
-          limit: args.limit,
-          min_strength: args.min_strength
+          limit: args.limit
         });
         return {
           results: results.map((e) => ({
@@ -211,7 +196,6 @@ function getToolDefinitions() {
           scope: { type: "string", description: "Filter by scope (also includes global)" },
           domain: { type: "string", description: "Filter by domain prefix" },
           limit: { type: "number", description: "Max results to return (default 20)" },
-          min_strength: { type: "number", description: "Minimum retrieval strength (0-1)" },
           budget: { type: "object", description: "Budget constraints for sub-agents", properties: { max_tokens: { type: "number" }, max_results: { type: "number" }, ttl_seconds: { type: "number" } } },
           caller_session_id: { type: "string", description: "Session ID of calling agent for budget enforcement" },
           include_episodes: { type: "boolean", description: "If true, include linked episode summaries for each engram (SP2 episodic anchoring)" }
@@ -224,8 +208,7 @@ function getToolDefinitions() {
         const meta = await plur.recallHybridWithMeta(args.query, {
           scope: args.scope,
           domain: args.domain,
-          limit: effectiveLimit,
-          min_strength: args.min_strength
+          limit: effectiveLimit
         });
         const results = meta.engrams;
         let truncated = false;
@@ -364,7 +347,7 @@ function getToolDefinitions() {
           const summary = { positive: 0, negative: 0, neutral: 0 };
           for (const { id, signal } of args.signals) {
             try {
-              plur.feedback(id, signal);
+              await plur.feedback(id, signal);
               results.push({ id, signal, success: true });
               summary[signal]++;
             } catch (err) {
@@ -374,7 +357,7 @@ function getToolDefinitions() {
           return { mode: "batch", results, summary };
         }
         try {
-          plur.feedback(args.id, args.signal);
+          await plur.feedback(args.id, args.signal);
           return { success: true, id: args.id, signal: args.signal };
         } catch (err) {
           if (err.message?.includes("readonly store")) {
@@ -431,14 +414,14 @@ function getToolDefinitions() {
           const engram = plur.getById(args.id);
           if (!engram) throw new Error(`Engram not found: ${args.id}`);
           if (engram.status === "retired") return { success: false, error: `Already retired: ${args.id}` };
-          plur.forget(args.id);
+          await plur.forget(args.id);
           return { success: true, retired: { id: engram.id, statement: engram.statement } };
         }
         if (args.search) {
           const matches = plur.recall(args.search, { limit: 100 });
           if (matches.length === 0) return { success: false, error: `No active engrams matching "${args.search}"` };
           if (matches.length === 1) {
-            plur.forget(matches[0].id);
+            await plur.forget(matches[0].id);
             return { success: true, retired: { id: matches[0].id, statement: matches[0].statement } };
           }
           return {
@@ -830,7 +813,7 @@ function getToolDefinitions() {
     },
     {
       name: "plur_status",
-      description: "Return system health \u2014 engram count, episode count, pack count, storage root",
+      description: "Return system health \u2014 running version, engram count, episode count, pack count, storage root",
       annotations: { title: "Status", readOnlyHint: true, idempotentHint: true },
       inputSchema: {
         type: "object",
@@ -839,6 +822,7 @@ function getToolDefinitions() {
       handler: async (_args, plur) => {
         const status = plur.status();
         return {
+          version: VERSION,
           engram_count: status.engram_count,
           episode_count: status.episode_count,
           pack_count: status.pack_count,
@@ -1173,6 +1157,20 @@ Include at least one engram_suggestion if ANYTHING was learned. An empty suggest
         return { tensions, count: tensions.length };
       }
     },
+    {
+      name: "plur_tensions_purge",
+      description: "Purge all conflict relations from local engrams \u2014 removes accumulated false positives from the legacy tension-detection system",
+      annotations: { title: "Purge Tensions", destructiveHint: true, idempotentHint: true },
+      inputSchema: { type: "object", properties: {} },
+      handler: async (_args, plur) => {
+        const result = plur.purgeTensions();
+        return {
+          purged_conflict_refs: result.purged_count,
+          engrams_modified: result.engrams_modified,
+          message: `Purged ${result.purged_count} conflict references from ${result.engrams_modified} engrams.`
+        };
+      }
+    },
     {
       name: "plur_episode_to_engram",
       description: "Promote an episode to a persistent episodic engram \u2014 useful when a session event deserves long-term memory",
@@ -1419,7 +1417,6 @@ Include at least one engram_suggestion if ANYTHING was learned. An empty suggest
 
 // src/server.ts
 import { z } from "zod";
-var VERSION = "0.9.7";
 var INSTRUCTIONS = `PLUR is your persistent memory. Corrections, preferences, and conventions persist across sessions as engrams.
 
 PLUR is a GLOBAL tool \u2014 one MCP server, one engram store (~/.plur/), available in every project. Multi-project scoping uses domain/scope fields on engrams, not separate installations.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@plur-ai/mcp",
-  "version": "0.9.7",
+  "version": "0.9.9",
   "type": "module",
   "bin": {
     "plur-mcp": "dist/index.js"
@@ -13,7 +13,7 @@
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.12.0",
     "zod": "^3.23.0",
-    "@plur-ai/core": "0.9.7"
+    "@plur-ai/core": "0.9.9"
   },
   "devDependencies": {
     "@types/node": "^25.5.0"