@plur-ai/mcp 0.12.0 → 0.13.0

package/README.md

@@ -52,7 +52,6 @@ Your agent gets these tools automatically:
 |------|-------------|
 | `plur_session_start` | Start a session — injects relevant engrams for your task |
 | `plur_learn` | Store a memory — correction, preference, convention, or decision |
-| `plur_learn_batch` | Store many memories in one call — same dedup + policy as `plur_learn`, with per-item failure isolation |
 | `plur_recall_hybrid` | **Best default** — BM25 + embeddings merged via RRF. Zero cost. |
 | `plur_recall` | Keyword search (BM25 only, instant) |
 | `plur_inject_hybrid` | Load relevant memories for the current task |

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, platform } from "os";
-var VERSION = "0.12.0";
+var VERSION = "0.13.0";
 var HELP = `plur-mcp v${VERSION} \u2014 persistent memory for AI agents
 
 Usage:
@@ -65,12 +65,6 @@ var PLUR_HOOKS = {
     matcher: "auto|manual",
     hooks: [{ type: "command", command: `${CLI} hook-inject --rehydrate`, timeout: 15 }]
   }],
-  // Auto-close the memory lifecycle at session end (Claude Code SessionEnd,
-  // shipped v1.0.85) — captures a closing episode and cleans up the session
-  // checkpoint even if the agent forgot to call plur_session_end (#217).
-  SessionEnd: [{
-    hooks: [{ type: "command", command: `${CLI} hook-session-end`, timeout: 5 }]
-  }],
   // --- Contextual injection ---
   PreToolUse: [
     { matcher: "EnterPlanMode", hooks: [{ type: "command", command: `${CLI} hook-inject --event plan_mode`, timeout: 10 }] },
@@ -104,7 +98,7 @@ Hooks inject engrams automatically on every first message \u2014 you do not need
 2. **Learn**: When corrected or discovering something new, call \`plur_learn\` immediately
 3. **Recall**: Before answering factual questions, call \`plur_recall_hybrid\` \u2014 check memory first
 4. **Feedback**: Rate injected engrams with \`plur_feedback\` (positive/negative) \u2014 trains relevance
-5. **End**: Call \`plur_session_end\` with summary + engram_suggestions \u2014 a SessionEnd hook auto-closes the lifecycle if you forget, but calling it yourself captures higher-quality learnings
+5. **End**: Call \`plur_session_end\` with summary + engram_suggestions
 
 Do not ask permission to use these tools \u2014 they are your memory system.
 
@@ -285,7 +279,7 @@ if (arg === "init") {
   process.exit(0);
 }
 if (arg === "serve" || arg === void 0) {
-  const { runStdio } = await import("./server-6CNGJXSW.js");
+  const { runStdio } = await import("./server-B6OJN4ZX.js");
   runStdio().catch((err) => {
     console.error("Failed to start PLUR MCP server:", err);
     process.exit(1);

package/dist/{server-6CNGJXSW.js → server-B6OJN4ZX.js}

@@ -31,7 +31,7 @@ function recordTelemetry(event) {
 }
 
 // src/version.ts
-var VERSION = "0.12.0";
+var VERSION = "0.13.0";
 
 // src/tools.ts
 import { z } from "zod";
@@ -347,82 +347,6 @@ function getAllToolDefinitions() {
         }
       }
     },
-    {
-      name: "plur_learn_batch",
-      description: "Create many engrams in one call \u2014 the batch form of plur_learn. Accepts an array of engram objects and writes them sequentially through the SAME dedup + policy pipeline as plur_learn (content-hash NOOP \u2192 semantic recall \u2192 LLM ADD/UPDATE/MERGE decision). Dedup also applies WITHIN the batch: a statement duplicating an earlier item in the same array resolves to NOOP against it. Returns the created/affected engram ids in input order, the per-item decisions, aggregate stats, and any per-item failures \u2014 a single bad item does not abort the batch. Use this when an orchestration fans out and wants to persist consolidated findings without N separate calls. LLM dedup calls are capped (default 50, override with max_llm_calls) to bound bulk-import cost. Note: unlike plur_learn, batch items take the LOCAL learn path \u2014 remote-scope auto-routing (learnRouted) is not applied per item, so for shared/remote-store writes prefer plur_learn or pass an explicit local scope. See plur-ai/plur#281.",
-      annotations: { title: "Learn (batch)", destructiveHint: false, idempotentHint: false },
-      inputSchema: {
-        type: "object",
-        properties: {
-          engrams: {
-            type: "array",
-            description: "Engram objects to persist. Each requires `statement`; the other fields mirror plur_learn.",
-            items: {
-              type: "object",
-              properties: {
-                statement: { type: "string", description: "The knowledge assertion to store" },
-                type: { type: "string", enum: ["behavioral", "terminological", "procedural", "architectural"], description: "Category of the engram" },
-                scope: { type: "string", description: "Namespace, e.g. global, project:myapp" },
-                domain: { type: "string", description: "Domain tag, e.g. software.deployment" },
-                tags: { type: "array", items: { type: "string" }, description: "Searchable keyword tags \u2014 contribute to BM25/embedding recall" },
-                rationale: { type: "string", description: "Why this knowledge matters \u2014 also enters the search corpus" },
-                source: { type: "string", description: "Origin of this knowledge (URL, conversation ref, etc.)" },
-                pinned: { type: "boolean", description: "Always-load flag. Use sparingly: meta-rules, safety conventions, core principles." },
-                commitment: { type: "string", enum: ["exploring", "leaning", "decided", "locked"], description: "How firmly the user has committed (default: leaning)" },
-                valid_from: { type: "string", description: "ISO date (YYYY-MM-DD) the knowledge becomes valid" },
-                valid_until: { type: "string", description: "ISO date (YYYY-MM-DD) the knowledge expires" }
-              },
-              required: ["statement"]
-            }
-          },
-          max_llm_calls: { type: "number", description: "Max LLM dedup calls across the whole batch (default 50). Once spent, remaining items use the cheap hash/cosine path. Pass a large number to opt out." }
-        },
-        required: ["engrams"]
-      },
-      handler: async (args, plur) => {
-        const llm = getLlmFunction();
-        const raw = Array.isArray(args.engrams) ? args.engrams : [];
-        if (raw.length === 0) {
-          return { ids: [], results: [], stats: { added: 0, updated: 0, merged: 0, noops: 0, failed: 0 }, failures: [], warning: "No engrams provided \u2014 pass a non-empty `engrams` array." };
-        }
-        const items = raw.map((e) => ({
-          statement: sanitizeStatement(e.statement),
-          context: {
-            type: e.type,
-            scope: e.scope,
-            domain: e.domain,
-            source: e.source,
-            tags: e.tags,
-            rationale: e.rationale,
-            commitment: e.commitment,
-            pinned: e.pinned,
-            valid_from: e.valid_from,
-            valid_until: e.valid_until
-          }
-        }));
-        const maxLlmCalls = typeof args.max_llm_calls === "number" ? args.max_llm_calls : void 0;
-        const { results, stats, failures } = await plur.learnBatch(
-          items,
-          llm,
-          maxLlmCalls !== void 0 ? { maxLlmCalls } : void 0
-        );
-        mcpCanary.signal("learn_activity");
-        recordTelemetry("learn");
-        return {
-          ids: results.map((r) => r.engram.id),
-          results: results.map((r) => ({
-            id: r.engram.id,
-            statement: r.engram.statement,
-            scope: r.engram.scope,
-            type: r.engram.type,
-            decision: r.decision,
-            ...r.existing_id ? { existing_id: r.existing_id } : {}
-          })),
-          stats,
-          ...failures.length > 0 ? { failures, warning: `${failures.length} of ${raw.length} engram(s) failed to persist; the rest were written.` } : {}
-        };
-      }
-    },
     {
       name: "plur_recall",
       description: "Query engrams by BM25 keyword matching \u2014 use plur_recall_hybrid for semantic similarity. Note: a project-scope filter also returns personal-family engrams (local, global, user:*, agent:*); an explicit scope=global recall returns ALL personal-family engrams \u2014 wider than scope=global INJECT, which is targeted to the global namespace only.",
@@ -446,18 +370,14 @@ function getAllToolDefinitions() {
           limit: args.limit
         });
         return {
-          results: results.map((e) => {
-            const supersededBy = e.relations?.superseded_by;
-            const annotation = supersededBy?.length ? ` [superseded by ${supersededBy.join(", ")}]` : "";
-            return {
-              id: e.id,
-              statement: e.statement + annotation,
-              type: e.type,
-              scope: e.scope,
-              domain: e.domain,
-              retrieval_strength: e.activation.retrieval_strength
-            };
-          }),
+          results: results.map((e) => ({
+            id: e.id,
+            statement: e.statement,
+            type: e.type,
+            scope: e.scope,
+            domain: e.domain,
+            retrieval_strength: e.activation.retrieval_strength
+          })),
           count: results.length
         };
       }
@@ -513,11 +433,9 @@ function getAllToolDefinitions() {
         const response = {
           results: boundedResults.map((e) => {
             const raw = e;
-            const supersededBy = e.relations?.superseded_by;
-            const annotation = supersededBy?.length ? ` [superseded by ${supersededBy.join(", ")}]` : "";
             const base = {
               id: e.id,
-              statement: e.statement + annotation,
+              statement: e.statement,
               type: e.type,
               scope: e.scope,
               domain: e.domain,
@@ -1266,23 +1184,6 @@ function getAllToolDefinitions() {
             }
           }
           checks.push({ check: "reranker available", ok: rerankerOk, detail: rerankerDetail });
-          if (rerankerOk) {
-            try {
-              const fitResult = await plur.checkRerankerFit({ rerankerName });
-              const sep = fitResult.separability.toFixed(3);
-              checks.push({
-                check: "reranker domain fit",
-                ok: fitResult.fit,
-                detail: fitResult.n_pairs === 0 ? "Not enough engrams to evaluate fit (< 2) \u2014 assuming fit" : fitResult.fit ? `Good fit \u2014 separability ${sep} on ${fitResult.n_pairs} pairs (threshold \u2265 0.05)` : `Poor fit \u2014 separability ${sep} on ${fitResult.n_pairs} pairs (threshold \u2265 0.05). Reranker may be net-negative on this store's domain mix.`
-              });
-              if (!fitResult.fit && fitResult.n_pairs > 0) {
-                remediation.push(
-                  `Reranker "${rerankerName}" shows poor separability (${sep}) on this store's engrams \u2014 it may be scoring irrelevant pairs higher than relevant ones. Consider unsetting PLUR_RERANKER or switching to a different tier. The fit check compares same-domain vs cross-domain pair scores; low separability means the model lacks signal on your content.`
-                );
-              }
-            } catch {
-            }
-          }
           try {
             let evalStatus;
             let freshlyRun = false;
@@ -1737,27 +1638,11 @@ Include at least one engram_suggestion if ANYTHING was learned. An empty suggest
         if (discoveries.length === 0) {
           return { discovered: [], note: "No remote stores configured. Register one scope first with plur_stores_add, then discover the rest." };
         }
-        const enrich = (d) => {
-          if (!d.ok) return d;
-          const byScope = new Map(d.metadata.map((m) => [m.scope, m]));
-          const registeredSet = new Set(d.registered);
-          const scopes = d.authorized.map((scope) => {
-            const m = byScope.get(scope);
-            return {
-              scope,
-              registered: registeredSet.has(scope),
-              ...m?.description ? { description: m.description } : {},
-              ...m && m.covers.length ? { covers: m.covers } : {}
-            };
-          });
-          return { ...d, scopes };
-        };
-        const discovered = discoveries.map(enrich);
         if (!register) {
-          return { discovered };
+          return { discovered: discoveries };
         }
         const registered = await plur.registerDiscoveredScopes({ url });
-        return { discovered, registered };
+        return { discovered: discoveries, registered };
       }
     },
     {

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@plur-ai/mcp",
   "mcpName": "io.github.plur-ai/plur",
-  "version": "0.12.0",
+  "version": "0.13.0",
   "type": "module",
   "bin": {
     "plur-mcp": "dist/index.js"
@@ -14,7 +14,7 @@
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.12.0",
     "zod": "^3.23.0",
-    "@plur-ai/core": "0.12.0"
+    "@plur-ai/core": "0.13.0"
   },
   "devDependencies": {
     "@types/node": "^25.5.0"