@plur-ai/mcp 0.5.3 → 0.6.0

package/README.md

@@ -50,31 +50,32 @@ Your agent gets these tools automatically:
 
 | Tool | What it does |
 |------|-------------|
-| `plur.learn` | Store a memory — correction, preference, convention, or decision |
-| `plur.recall` | Keyword search (BM25, instant) |
-| `plur.recall.hybrid` | **Best default** — BM25 + embeddings merged via RRF. Zero cost. |
-| `plur.inject` | Load relevant memories for the current task |
-| `plur.feedback` | Rate a memory — trains relevance over time |
-| `plur.forget` | Retire a memory (history preserved) |
-| `plur.sync` | Sync memory across machines via git |
-| `plur.sync.status` | Check sync state |
-| `plur.capture` | Record a session event |
-| `plur.timeline` | Query session history |
-| `plur.ingest` | Extract learnings from text |
-| `plur.packs.install` | Install a shareable memory pack |
-| `plur.packs.list` | List installed packs |
-| `plur.status` | System health |
+| `plur_session_start` | Start a session — injects relevant engrams for your task |
+| `plur_learn` | Store a memory — correction, preference, convention, or decision |
+| `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 |
+| `plur_feedback` | Rate a memory — trains relevance over time |
+| `plur_forget` | Retire a memory (history preserved) |
+| `plur_session_end` | End a session — captures summary and new learnings |
+| `plur_capture` | Record a session event |
+| `plur_timeline` | Query session history |
+| `plur_ingest` | Extract learnings from text |
+| `plur_sync` | Sync memory across machines via git |
+| `plur_packs_install` | Install a shareable memory pack |
+| `plur_packs_list` | List installed packs |
+| `plur_status` | System health |
 
 ## Sync across machines
 
 Your agent can sync memory to any git remote:
 
 ```
-Agent: plur.sync({ remote: "git@github.com:you/plur-memory.git" })
+Agent: plur_sync({ remote: "git@github.com:you/plur-memory.git" })
 → "Initialized and pushed."
 
 # On another machine, same remote:
-Agent: plur.sync()
+Agent: plur_sync()
 → "Synced. Pulled 12 remote commits."
 ```
 

package/dist/index.js

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

package/dist/{server-VFKTDY7O.js → server-5BXYBMHX.js}

@@ -297,8 +297,15 @@ function getToolDefinitions() {
           }
           return { mode: "batch", results, summary };
         }
-        plur.feedback(args.id, args.signal);
-        return { success: true, id: args.id, signal: args.signal };
+        try {
+          plur.feedback(args.id, args.signal);
+          return { success: true, id: args.id, signal: args.signal };
+        } catch (err) {
+          if (err.message?.includes("readonly store")) {
+            return { success: false, id: args.id, signal: args.signal, note: "Engram is in a readonly store. Feedback noted for this session but not persisted." };
+          }
+          throw err;
+        }
       }
     },
     {
@@ -742,27 +749,35 @@ You have ${store_stats.engram_count} engrams but none matched this task. Call pl
     },
     {
       name: "plur_session_end",
-      description: "End a session \u2014 captures an episode and creates engrams from suggestions. Call before the conversation ends.",
+      description: `End a session. BEFORE calling this tool, review the conversation and extract learnings:
+
+1. Corrections the user made ("no, use X not Y") \u2192 type: behavioral
+2. Preferences stated ("always X", "never Y") \u2192 type: behavioral
+3. Codebase patterns discovered (naming, structure, conventions) \u2192 type: architectural
+4. Technical facts learned (API quirks, config, gotchas) \u2192 type: procedural
+5. Terminology defined or clarified \u2192 type: terminological
+
+Include at least one engram_suggestion if ANYTHING was learned. An empty suggestions array means nothing worth remembering happened \u2014 this should be rare.`,
       annotations: { title: "Session End", destructiveHint: false, idempotentHint: false },
       inputSchema: {
         type: "object",
         properties: {
-          summary: { type: "string", description: "What happened in this session" },
+          summary: { type: "string", description: "What happened in this session (1-3 sentences)" },
           session_id: { type: "string", description: "Session ID from plur_session_start" },
           engram_suggestions: {
             type: "array",
             items: {
               type: "object",
               properties: {
-                statement: { type: "string", description: "The knowledge assertion" },
+                statement: { type: "string", description: "A concise, reusable assertion. Write it as advice to your future self." },
                 type: { type: "string", enum: ["behavioral", "terminological", "procedural", "architectural"] }
               },
               required: ["statement"]
             },
-            description: "New learnings to capture as engrams"
+            description: "Learnings from this session. Review the conversation for corrections, preferences, patterns, and technical facts before calling."
           }
         },
-        required: ["summary"]
+        required: ["summary", "engram_suggestions"]
       },
       handler: async (args, plur) => {
         const summary = args.summary;
@@ -896,7 +911,7 @@ You have ${store_stats.engram_count} engrams but none matched this task. Call pl
 
 // src/server.ts
 import { z } from "zod";
-var VERSION = "0.5.3";
+var VERSION = "0.6.0";
 var INSTRUCTIONS = `PLUR is your persistent memory. Corrections, preferences, and conventions persist across sessions as engrams.
 
 REQUIRED at session boundaries:

package/package.json

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