@plur-ai/mcp 0.11.0 → 0.13.0

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.11.0";
+var VERSION = "0.13.0";
 var HELP = `plur-mcp v${VERSION} \u2014 persistent memory for AI agents
 
 Usage:
@@ -279,7 +279,7 @@ if (arg === "init") {
   process.exit(0);
 }
 if (arg === "serve" || arg === void 0) {
-  const { runStdio } = await import("./server-M7GBKD4M.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-M7GBKD4M.js → server-B6OJN4ZX.js}

@@ -31,9 +31,10 @@ function recordTelemetry(event) {
 }
 
 // src/version.ts
-var VERSION = "0.11.0";
+var VERSION = "0.13.0";
 
 // src/tools.ts
+import { z } from "zod";
 function makeHttpLlm(baseUrl, apiKey, model = "gpt-4o-mini") {
   return async (prompt) => {
     const response = await fetch(`${baseUrl.replace(/\/$/, "")}/chat/completions`, {
@@ -55,6 +56,73 @@ function makeHttpLlm(baseUrl, apiKey, model = "gpt-4o-mini") {
     return data.choices?.[0]?.message?.content ?? "";
   };
 }
+function jsonSchemaPropToZod(prop) {
+  if (!prop || typeof prop !== "object") return z.unknown();
+  const variants = prop.anyOf ?? prop.oneOf;
+  if (Array.isArray(variants) && variants.length > 0) {
+    const zodVariants = variants.map(jsonSchemaPropToZod);
+    if (zodVariants.length === 1) return zodVariants[0];
+    return z.union(zodVariants);
+  }
+  if (prop.type === "string") return prop.enum ? z.enum(prop.enum) : z.string();
+  if (prop.type === "number" || prop.type === "integer") return z.number();
+  if (prop.type === "boolean") return z.boolean();
+  if (prop.type === "array") {
+    const itemSchema = prop.items ? jsonSchemaPropToZod(prop.items) : z.unknown();
+    return z.preprocess((val) => {
+      if (typeof val !== "string") return val;
+      const trimmed = val.trim();
+      if (trimmed.startsWith("[")) {
+        try {
+          const parsed = JSON.parse(trimmed);
+          return Array.isArray(parsed) ? parsed : val;
+        } catch {
+          return val;
+        }
+      }
+      if (prop.items?.type === "string") {
+        return trimmed.length === 0 ? [] : trimmed.split(",").map((s) => s.trim()).filter((s) => s.length > 0);
+      }
+      return val;
+    }, z.array(itemSchema));
+  }
+  if (prop.type === "object" && prop.properties) {
+    const shape = {};
+    for (const [k, p] of Object.entries(prop.properties)) {
+      const field = jsonSchemaPropToZod(p);
+      shape[k] = prop.required?.includes(k) ? field : field.optional();
+    }
+    return z.object(shape).passthrough();
+  }
+  return z.unknown();
+}
+function validateToolArgs(tool, rawArgs) {
+  const schema = tool.inputSchema;
+  if (!schema?.properties) return { ok: true, data: rawArgs };
+  const shape = {};
+  for (const [key, prop] of Object.entries(schema.properties)) {
+    const field = jsonSchemaPropToZod(prop);
+    shape[key] = schema.required?.includes(key) ? field : field.optional();
+  }
+  const parsed = z.object(shape).passthrough().safeParse(rawArgs);
+  if (!parsed.success) {
+    const receivedFields = Object.keys(rawArgs);
+    const details = parsed.error.issues.map((i) => `${i.path.join(".") || "root"}: ${i.message}`).join(", ");
+    const hasArrayParam = Object.values(schema.properties ?? {}).some((p) => p?.type === "array");
+    const arrayBugHint = receivedFields.length === 0 && hasArrayParam ? ' Known client-side bug (plur-ai/plur#297): some MCP clients drop the entire arguments payload when an array-typed parameter is included. Retry passing array parameters as a JSON string (e.g. tags: "[\\"a\\",\\"b\\"]") or a comma-separated string (tags: "a, b") \u2014 the server coerces both back into arrays.' : "";
+    const receivedNote = receivedFields.length > 0 ? `Received fields: [${receivedFields.join(", ")}].` : "Received no fields (the arguments object was empty).";
+    return {
+      ok: false,
+      errorPayload: {
+        error: `Invalid arguments: ${details}. ${receivedNote} The call reached the server \u2014 this is a malformed-arguments error, not a transport failure. Fix the field(s) named above and retry; do not abandon the call.` + arrayBugHint,
+        success: false,
+        received_fields: receivedFields,
+        _isError: true
+      }
+    };
+  }
+  return { ok: true, data: parsed.data };
+}
 var PLUR_GUIDE_EMPTY = `## PLUR \u2014 Empty Store
 
 You have **0 engrams**. This session's learnings will be lost unless you store them.
@@ -111,7 +179,67 @@ mcpCanary.expect({
   description: "Learning from corrections",
   fix: "Call plur_learn when corrected. If using hooks, verify they are installed."
 });
-function getToolDefinitions() {
+var CURSOR_CORE_TOOL_NAMES = /* @__PURE__ */ new Set([
+  "plur_session_start",
+  "plur_session_end",
+  "plur_learn",
+  "plur_recall_hybrid",
+  "plur_feedback",
+  "plur_forget",
+  "plur_status",
+  "plur_doctor",
+  "plur_packs_uninstall",
+  "plur_tensions_purge"
+]);
+function buildAdminDispatchTool(all) {
+  const byName = new Map(all.map((t) => [t.name, t]));
+  const adminActions = all.map((t) => t.name).filter((n) => !CURSOR_CORE_TOOL_NAMES.has(n)).sort();
+  return {
+    name: "plur_admin",
+    description: `Dispatch for less-common PLUR operations (packs, sync, tensions, stores, timeline, ingest, and more), collapsed into one tool so Cursor's ~40-tool-per-workspace limit is not exhausted by PLUR alone. Set "action" to the underlying tool name and "args" to that tool's normal arguments. Valid actions: ${adminActions.join(", ")}.`,
+    annotations: { title: "Admin dispatch", readOnlyHint: false },
+    inputSchema: {
+      type: "object",
+      properties: {
+        // No `enum` here — an invalid action must reach the handler's custom
+        // Unknown-action message with the full valid-actions list, not fail
+        // at top-level schema validation with a generic "Invalid arguments"
+        // error. If `enum: adminActions` were set, the top-level
+        // CallToolRequestSchema handler's Zod validation would reject
+        // unknown actions before this handler's `if (!target)` branch ever
+        // ran.
+        action: { type: "string", description: "Which underlying plur_* tool to invoke" },
+        args: { type: "object", description: "Arguments for the chosen action, matching that tool's normal input schema", additionalProperties: true }
+      },
+      required: ["action"]
+    },
+    handler: async (args, plur) => {
+      const action = args.action;
+      const target = byName.get(action);
+      if (!target) {
+        return { error: `Unknown action "${action}". Valid actions: ${adminActions.join(", ")}`, success: false, _isError: true };
+      }
+      const innerArgs = args.args ?? {};
+      const validated = validateToolArgs(target, innerArgs);
+      if (!validated.ok) {
+        return { ...validated.errorPayload, error: `${action}: ${validated.errorPayload.error}` };
+      }
+      try {
+        return await target.handler(validated.data, plur);
+      } catch (err) {
+        const message = err?.message ?? String(err);
+        throw new Error(`${action}: ${message}`);
+      }
+    }
+  };
+}
+function getToolDefinitions(profile = "full") {
+  const all = getAllToolDefinitions();
+  if (profile !== "cursor") return all;
+  const core = all.filter((t) => CURSOR_CORE_TOOL_NAMES.has(t.name));
+  return [...core, buildAdminDispatchTool(all)];
+}
+function getAllToolDefinitions() {
   return [
     {
       name: "plur_learn",
@@ -964,7 +1092,7 @@ function getToolDefinitions() {
     },
     {
       name: "plur_doctor",
-      description: 'Diagnose the PLUR install. Reports whether the embedding model loaded, whether hybrid search is fully operational, and \u2014 for any configured enterprise/remote store \u2014 whether its auth is valid (probes /api/v1/me and decodes token expiry), so a dead or soon-to-expire token surfaces instead of hiding behind a "healthy" report. Run this first when recall feels off or team engrams stop syncing.',
+      description: 'Diagnose the PLUR ENGINE (embedder, hybrid search, remote-store auth) \u2014 not hook/MCP wiring. Reports whether the embedding model loaded, whether hybrid search is fully operational, and \u2014 for any configured enterprise/remote store \u2014 whether its auth is valid (probes /api/v1/me and decodes token expiry), so a dead or soon-to-expire token surfaces instead of hiding behind a "healthy" report. Run this first when recall feels off or team engrams stop syncing. Does NOT check .cursor/mcp.json, .cursor/hooks.json, or the live MCP tool count \u2014 for that, run the `plur doctor` CLI command in a terminal (a different, more thorough check with the same name).',
       annotations: { title: "Doctor", readOnlyHint: false, idempotentHint: false },
       inputSchema: {
         type: "object",
@@ -1931,7 +2059,6 @@ Include at least one engram_suggestion if ANYTHING was learned. An empty suggest
 }
 
 // src/server.ts
-import { z } from "zod";
 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.
@@ -2049,49 +2176,9 @@ Use \`scope\` to namespace engrams per project:
 
 Override with \`PLUR_PATH\` environment variable.
 `;
-function jsonSchemaPropToZod(prop) {
-  if (!prop || typeof prop !== "object") return z.unknown();
-  const variants = prop.anyOf ?? prop.oneOf;
-  if (Array.isArray(variants) && variants.length > 0) {
-    const zodVariants = variants.map(jsonSchemaPropToZod);
-    if (zodVariants.length === 1) return zodVariants[0];
-    return z.union(zodVariants);
-  }
-  if (prop.type === "string") return prop.enum ? z.enum(prop.enum) : z.string();
-  if (prop.type === "number" || prop.type === "integer") return z.number();
-  if (prop.type === "boolean") return z.boolean();
-  if (prop.type === "array") {
-    const itemSchema = prop.items ? jsonSchemaPropToZod(prop.items) : z.unknown();
-    return z.preprocess((val) => {
-      if (typeof val !== "string") return val;
-      const trimmed = val.trim();
-      if (trimmed.startsWith("[")) {
-        try {
-          const parsed = JSON.parse(trimmed);
-          return Array.isArray(parsed) ? parsed : val;
-        } catch {
-          return val;
-        }
-      }
-      if (prop.items?.type === "string") {
-        return trimmed.length === 0 ? [] : trimmed.split(",").map((s) => s.trim()).filter((s) => s.length > 0);
-      }
-      return val;
-    }, z.array(itemSchema));
-  }
-  if (prop.type === "object" && prop.properties) {
-    const shape = {};
-    for (const [k, p] of Object.entries(prop.properties)) {
-      const field = jsonSchemaPropToZod(p);
-      shape[k] = prop.required?.includes(k) ? field : field.optional();
-    }
-    return z.object(shape).passthrough();
-  }
-  return z.unknown();
-}
-async function createServer(plur) {
+async function createServer(plur, options) {
   const instance = plur ?? new Plur2();
-  const tools = getToolDefinitions();
+  const tools = getToolDefinitions(options?.profile ?? "full");
   checkForUpdate("@plur-ai/mcp", VERSION, (r) => {
     if (r.updateAvailable) {
       console.error(`[plur] Update available: ${r.current} \u2192 ${r.latest}. Run: npx @plur-ai/mcp@latest`);
@@ -2128,33 +2215,26 @@ async function createServer(plur) {
     mcpCanary.tick();
     try {
       let args = request.params.arguments ?? {};
-      const schema = tool.inputSchema;
-      if (schema?.properties) {
-        const shape = {};
-        for (const [key, prop] of Object.entries(schema.properties)) {
-          const field = jsonSchemaPropToZod(prop);
-          shape[key] = schema.required?.includes(key) ? field : field.optional();
-        }
-        const parsed = z.object(shape).passthrough().safeParse(args);
-        if (!parsed.success) {
-          const receivedFields = Object.keys(args);
-          const details = parsed.error.issues.map((i) => `${i.path.join(".") || "root"}: ${i.message}`).join(", ");
-          const receivedNote = receivedFields.length > 0 ? `Received fields: [${receivedFields.join(", ")}].` : "Received no fields (the arguments object was empty).";
-          const hasArrayParam = Object.values(schema.properties).some((p) => p?.type === "array");
-          const arrayBugHint = receivedFields.length === 0 && hasArrayParam ? ' Known client-side bug (plur-ai/plur#297): some MCP clients drop the entire arguments payload when an array-typed parameter is included. Retry passing array parameters as a JSON string (e.g. tags: "[\\"a\\",\\"b\\"]") or a comma-separated string (tags: "a, b") \u2014 the server coerces both back into arrays.' : "";
-          return {
-            content: [{ type: "text", text: JSON.stringify({
-              error: `Invalid arguments: ${details}. ${receivedNote} The call reached the server \u2014 this is a malformed-arguments error, not a transport failure. Fix the field(s) named above and retry; do not abandon the call.` + arrayBugHint,
-              success: false,
-              received_fields: receivedFields
-            }) }],
-            isError: true
-          };
-        }
-        args = parsed.data;
+      const validated = validateToolArgs(tool, args);
+      if (!validated.ok) {
+        return {
+          content: [{ type: "text", text: JSON.stringify(validated.errorPayload) }],
+          isError: true
+        };
       }
+      args = validated.data;
       const result = await tool.handler(args, instance);
-      return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+      let payload = result;
+      let resultIsError = false;
+      if (result && typeof result === "object" && result._isError === true) {
+        resultIsError = true;
+        const { _isError, ...rest } = result;
+        payload = rest;
+      }
+      return {
+        content: [{ type: "text", text: JSON.stringify(payload, null, 2) }],
+        ...resultIsError ? { isError: true } : {}
+      };
     } catch (err) {
       const message = err?.message ?? String(err);
       server.sendLoggingMessage({ level: "error", data: `Tool ${request.params.name} failed: ${message}` });
@@ -2183,11 +2263,16 @@ async function createServer(plur) {
   server.setRequestHandler(ReadResourceRequestSchema, async (request) => {
     const uri = request.params.uri;
     if (uri === "plur://guide") {
+      const cursorNote = options?.profile === "cursor" ? `
+
+## Cursor tool profile
+
+Most tools above are NOT directly callable in this session \u2014 only ${[...CURSOR_CORE_TOOL_NAMES].join(", ")} are top-level tools here. Everything else in this guide is reachable through **plur_admin**: call it with \`{ action: "<tool name above>", args: {...} }\`.` : "";
       return {
         contents: [{
           uri: "plur://guide",
           mimeType: "text/markdown",
-          text: GUIDE_RESOURCE
+          text: GUIDE_RESOURCE + cursorNote
         }]
       };
     }
@@ -2275,7 +2360,8 @@ Please:
   return server;
 }
 async function runStdio() {
-  const server = await createServer();
+  const profile = process.env.PLUR_TOOL_PROFILE === "cursor" ? "cursor" : "full";
+  const server = await createServer(void 0, { profile });
   registerFlushOnExit({});
   const transport = new StdioServerTransport();
   await server.connect(transport);

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@plur-ai/mcp",
   "mcpName": "io.github.plur-ai/plur",
-  "version": "0.11.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.11.0"
+    "@plur-ai/core": "0.13.0"
   },
   "devDependencies": {
     "@types/node": "^25.5.0"