@plur-ai/mcp 0.5.0 → 0.5.2

package/dist/index.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 
 // src/index.ts
-var VERSION = "0.5.0";
+var VERSION = "0.5.2";
 var HELP = `plur-mcp v${VERSION} \u2014 persistent memory for AI agents
 
 Usage:
@@ -75,7 +75,7 @@ if (arg === "init") {
   process.exit(0);
 }
 if (arg === "serve" || arg === void 0) {
-  const { runStdio } = await import("./server-3QMSEZUP.js");
+  const { runStdio } = await import("./server-4WAIYC37.js");
   runStdio().catch((err) => {
     console.error("Failed to start PLUR MCP server:", err);
     process.exit(1);

package/dist/{server-3QMSEZUP.js → server-4WAIYC37.js}

@@ -36,19 +36,34 @@ function makeHttpLlm(baseUrl, apiKey, model = "gpt-4o-mini") {
     return data.choices?.[0]?.message?.content ?? "";
   };
 }
-var PLUR_GUIDE = `## PLUR Quick Start
+var PLUR_GUIDE_EMPTY = `## PLUR \u2014 Empty Store
+
+You have **0 engrams**. This session's learnings will be lost unless you store them.
+
+### What to store (call plur_learn):
+- When the user corrects you ("no, use X not Y")
+- When the user states a preference ("always do X", "never Y")
+- When you discover a convention or pattern in the codebase
+- Architecture decisions and their rationale
+
+### Session workflow:
+1. Work on your task
+2. Call **plur_learn** whenever you encounter something worth remembering
+3. Call **plur_session_end** before the conversation ends \u2014 suggest new engrams
 
-Persistent memory for AI agents. Corrections, preferences, and conventions stored as engrams.
+The more you store now, the smarter you start next session.`;
+var PLUR_GUIDE = `## PLUR Quick Start
 
 ### Session Workflow
-1. **plur_session_start** (you just called this) \u2014 get context
+1. **plur_session_start** (you just called this) \u2014 context loaded
 2. Work on your task
-3. **plur_feedback** \u2014 rate which injected engrams helped
-4. **plur_session_end** \u2014 capture summary + suggest new engrams
+3. Call **plur_learn** when the user corrects you or states a preference
+4. Call **plur_feedback** to rate which injected engrams helped
+5. Call **plur_session_end** before the conversation ends \u2014 suggest new engrams
 
 ### Core Tools
-- **plur_learn** \u2014 record patterns, preferences, insights
-- **plur_recall_hybrid** \u2014 search engrams
+- **plur_learn** \u2014 record corrections, preferences, patterns (CALL THIS OFTEN)
+- **plur_recall_hybrid** \u2014 search engrams by topic
 - **plur_forget** \u2014 retire an outdated engram`;
 function getToolDefinitions() {
   return [
@@ -672,6 +687,12 @@ function getToolDefinitions() {
         const session_id = crypto.randomUUID();
         const task = args.task;
         const tags = args.tags;
+        const status = plur.status();
+        const store_stats = {
+          engram_count: status.engram_count,
+          episode_count: status.episode_count,
+          pack_count: status.pack_count
+        };
         let engrams = null;
         try {
           const result = await plur.injectHybrid(task, {
@@ -696,10 +717,26 @@ function getToolDefinitions() {
             engrams = { text: lines.join("\n"), count: result.count, injected_ids: result.injected_ids };
           }
         }
+        let guide;
+        if (engrams) {
+          guide = `Session started with ${engrams.count} engrams from ${store_stats.engram_count} total. Remember to call plur_learn when corrected and plur_session_end before the conversation ends.`;
+        } else if (store_stats.engram_count === 0) {
+          guide = PLUR_GUIDE_EMPTY;
+        } else {
+          guide = `${PLUR_GUIDE}
+
+You have ${store_stats.engram_count} engrams but none matched this task. Call plur_learn to capture new learnings from this session.`;
+        }
+        const isFreshInstall = store_stats.engram_count === 0 && store_stats.episode_count === 0;
         return {
           session_id,
-          engrams,
-          guide: engrams ? "Session started. Workflow: work \u2192 plur_feedback \u2192 plur_session_end." : PLUR_GUIDE
+          engrams: engrams ?? [],
+          store_stats,
+          guide,
+          // Ask LLM to check back — MCP can't push, but we can request a follow-up
+          follow_up: store_stats.engram_count === 0 ? "This is a fresh store with 0 engrams. After your first exchange with the user, review what you learned and call plur_learn for any corrections, preferences, or patterns. Build the memory from this session." : void 0,
+          // On fresh install, suggest hook setup for reliable injection
+          setup_hint: isFreshInstall ? "IMPORTANT: For reliable memory injection, ask the user to run: npx @plur-ai/cli init \u2014 this installs Claude Code hooks that automatically inject engrams at conversation start and after context compaction. Without hooks, memory injection depends on you remembering to call plur_session_start." : void 0
         };
       }
     },
@@ -742,9 +779,12 @@ function getToolDefinitions() {
           session_id,
           channel: "mcp"
         });
+        const status = plur.status();
         return {
           engrams_created,
-          episode_id: episode.id
+          episode_id: episode.id,
+          total_engrams: status.engram_count,
+          hint: engrams_created === 0 ? "No engrams captured this session. If any corrections, preferences, or patterns came up, consider calling plur_learn before ending." : void 0
         };
       }
     },
@@ -856,16 +896,26 @@ function getToolDefinitions() {
 
 // src/server.ts
 import { z } from "zod";
-var VERSION = "0.5.0";
-var INSTRUCTIONS = `PLUR is your persistent memory. It stores corrections, preferences, and conventions as engrams that persist across sessions.
+var VERSION = "0.5.2";
+var INSTRUCTIONS = `PLUR is your persistent memory. Corrections, preferences, and conventions persist across sessions as engrams.
 
-Use PLUR proactively:
-- Call plur_session_start at session start with a task description \u2014 loads relevant context
-- Call plur_learn when the user corrects you, states a preference, or you discover a convention
-- Call plur_feedback after using recalled engrams to train relevance
-- Call plur_session_end before the conversation ends \u2014 captures learnings and session summary
+REQUIRED at session boundaries:
+- FIRST ACTION of every session: call plur_session_start with a task description
+- LAST ACTION before conversation ends: call plur_session_end with summary + engram_suggestions
 
-Do not ask permission to use these tools \u2014 they are your memory system.`;
+REQUIRED during the session:
+- When user corrects you ("no, use X not Y") \u2192 call plur_learn immediately
+- When user states a preference ("always X", "never Y") \u2192 call plur_learn immediately
+- When you discover a codebase convention or pattern \u2192 call plur_learn
+
+OPTIONAL but improves quality:
+- Call plur_feedback to rate which injected engrams helped (positive/negative)
+- Call plur_recall_hybrid before answering factual questions \u2014 the answer may be in memory
+
+Do not ask permission to use these tools \u2014 they are your memory system.
+
+Setup: If this is a fresh install, suggest the user run: npx @plur-ai/cli init
+This installs Claude Code hooks for automatic engram injection. Without hooks, injection only happens when you call plur_session_start.`;
 var GUIDE_RESOURCE = `# PLUR \u2014 Agent Guide
 
 ## What is PLUR?
@@ -924,6 +974,8 @@ Persistent memory for AI agents. Corrections, preferences, and conventions are s
 - **plur_stores_add** \u2014 register an additional engram store
 - **plur_stores_list** \u2014 list all configured stores
 
+**Note:** Multi-store is currently config-only. Recall and inject search the primary store. Cross-store search coming in a future release.
+
 ### Sync & Status
 - **plur_sync** \u2014 sync engrams across devices via git
 - **plur_sync_status** \u2014 check sync state

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@plur-ai/mcp",
-  "version": "0.5.0",
+  "version": "0.5.2",
   "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.0"
+    "@plur-ai/core": "0.5.2"
   },
   "devDependencies": {
     "@types/node": "^25.5.0"