prism-mcp-server 2.3.7 → 2.3.9

package/README.md

@@ -14,13 +14,15 @@
 
 ---
 
-## What's New in v2.3.5 — AI Reasoning Engine 🧠
+## What's New in v2.3.8 — LangGraph Research Agent 🔬
 
 | Feature | Description |
 |---|---|
-| 🕸️ **Neural Graph** | Interactive knowledge graph on the Mind Palace Dashboard — visualize how projects connect through shared keywords and categories using Vis.js force-directed layout. |
-| 🛡️ **Prompt Injection Shield** | Gemini-powered security scan in `session_health_check` — detects system override attempts, jailbreaks, and data exfiltration hidden in agent memory. Tuned to avoid false positives on normal dev commands. |
-| 🧬 **Fact Merger** | Async LLM contradiction resolution on every handoff save — if old context says "Postgres" and new says "MySQL", Gemini silently merges the facts in the background. Zero latency impact (fire-and-forget). |
+| 🤖 **LangGraph Research Agent** | New `examples/langgraph-agent/` — a 5-node agentic research agent (plan→search→analyze→decide→answer→save) with autonomous looping, MCP integration, and persistent memory. |
+| 🧠 **Agentic Memory** | `save_session` node persists research findings to a ledger — the agent doesn't just answer and forget. Routes to Prism's `session_save_ledger` in MCP-connected mode. |
+| 🔌 **MCP Client Bridge** | Raw JSON-RPC 2.0 client (`mcp_client.py`) for Python 3.9+ — dynamically discovers and wraps Prism MCP tools as LangChain `StructuredTool` objects. |
+| 🔧 **Storage Abstraction Fix** | Resource/Prompt handlers now route through `getStorage()` instead of calling Supabase directly — eliminates EOF crashes when reading `memory://` resources. |
+| 🛡️ **Error Boundaries** | Resource handlers catch errors gracefully and return proper MCP error responses (`isError: true`) instead of crashing the server process. |
 
 <details>
 <summary><strong>What's in v2.2.0</strong></summary>
@@ -251,6 +253,39 @@ Add to your Continue `config.json` or Cline MCP settings:
 
 ---
 
+## Claude Code + Gemini Startup Compatibility
+
+If you want consistent behavior across clients, treat startup in two phases:
+
+1. **Server availability**: ensure `prism-mcp` is enabled in MCP config so tools are available.
+2. **Context hydration**: explicitly call `session_load_context` at session start.
+
+Recommended startup call:
+
+```json
+{
+  "projectName": "<your-project>",
+  "level": "standard"
+}
+```
+
+Important distinction:
+
+- Auto-loading `prism-mcp` makes the server available.
+- It does **not** guarantee memory context is auto-hydrated unless your client runtime/hook invokes `session_load_context`.
+
+Client notes:
+
+- **Gemini runtimes** may support native startup execution depending on configuration.
+- **Claude Code** should use a local `SessionStart` hook in `~/.claude/settings.json` for deterministic startup context loading.
+
+Verification pattern (same for both clients):
+
+- Print a startup marker after successful `session_load_context` (for example, `PRISM_CONTEXT_LOADED`).
+- If the marker is missing, startup hydration did not run.
+
+---
+
 ## Use Cases
 
 | Scenario | How Prism MCP Helps |

package/dist/config.js

@@ -22,7 +22,7 @@
 // multi-tenant Row Level Security (RLS) for production hosting.
 export const SERVER_CONFIG = {
     name: "prism-mcp",
-    version: "2.3.7",
+    version: "2.3.9",
 };
 // ─── Required: Brave Search API Key ───────────────────────────
 export const BRAVE_API_KEY = process.env.BRAVE_API_KEY;
@@ -50,10 +50,9 @@ if (!BRAVE_ANSWERS_API_KEY) {
 export const SUPABASE_URL = process.env.SUPABASE_URL;
 export const SUPABASE_KEY = process.env.SUPABASE_KEY;
 export const SESSION_MEMORY_ENABLED = !!(SUPABASE_URL && SUPABASE_KEY);
-if (SESSION_MEMORY_ENABLED) {
-    console.error("Session memory enabled (Supabase configured)");
-}
-else {
+// Note: debug() is defined at the bottom of this file; these lines
+// execute at import time after the full module is loaded by Node.
+if (!SESSION_MEMORY_ENABLED) {
     console.error("Info: Session memory disabled (set SUPABASE_URL + SUPABASE_KEY to enable)");
 }
 // ─── v2.0: Storage Backend Selection ─────────────────────────
@@ -64,7 +63,7 @@ else {
 // Set PRISM_STORAGE=local to use SQLite (once implemented).
 // Set PRISM_STORAGE=supabase to use Supabase REST API (default).
 export const PRISM_STORAGE = process.env.PRISM_STORAGE || "supabase";
-console.error(`Storage backend: ${PRISM_STORAGE}`);
+// Logged at debug level — see debug() at bottom of file
 // ─── Optional: Multi-Tenant User ID ──────────────────────────
 // REVIEWER NOTE: When multiple users share the same Supabase instance,
 // PRISM_USER_ID isolates their data. Each user sets a unique ID in their
@@ -76,9 +75,7 @@ console.error(`Storage backend: ${PRISM_STORAGE}`);
 // For enterprise: use a stable unique identifier (UUID, email hash, etc.)
 // For personal use: any unique string works (e.g., "alice", "bob")
 export const PRISM_USER_ID = process.env.PRISM_USER_ID || "default";
-if (PRISM_USER_ID !== "default") {
-    console.error(`Multi-tenant mode: user_id="${PRISM_USER_ID}"`);
-}
+// Multi-tenant info logged at debug level in startServer()
 // ─── v2.1: Auto-Capture Feature ─────────────────────────────
 // REVIEWER NOTE: Automatically captures HTML snapshots of local dev servers
 // when handoffs are saved. Prevents UI context loss between sessions.
@@ -91,3 +88,13 @@ export const PRISM_CAPTURE_PORTS = (process.env.PRISM_CAPTURE_PORTS || "3000,300
 if (PRISM_AUTO_CAPTURE) {
     console.error(`[AutoCapture] Enabled for ports: ${PRISM_CAPTURE_PORTS.join(", ")}`);
 }
+// ─── Debug Logging ──────────────────────────────────────────────
+// Set PRISM_DEBUG=true to enable verbose startup and operational logs.
+// When disabled (default), only warnings and errors are printed.
+export const PRISM_DEBUG = process.env.PRISM_DEBUG === "true";
+/** Conditional debug logger — only prints when PRISM_DEBUG=true. */
+export function debug(...args) {
+    if (PRISM_DEBUG) {
+        console.error(...args);
+    }
+}

package/dist/dashboard/ui.js

@@ -1,5 +1,5 @@
 /**
- * Mind Palace Dashboard — UI Renderer (v2.3.4)
+ * Mind Palace Dashboard — UI Renderer (v2.3.7)
  *
  * Pure CSS + Vanilla JS single-page dashboard.
  * No build step, no Tailwind, no framework — served as a template literal.
@@ -279,7 +279,7 @@ export function renderDashboardHTML() {
       <div class="logo">
         <span class="logo-icon">🧠</span>
         Prism Mind Palace
-        <span class="version-badge">v2.3.4</span>
+        <span class="version-badge">v2.3.7</span>
       </div>
       <div class="selector">
         <select id="projectSelect">

package/dist/server.js

@@ -58,7 +58,7 @@ ListResourcesRequestSchema, ListResourceTemplatesRequestSchema, ReadResourceRequ
 // Claude Desktop that the attached resource has changed.
 // Without this, the paperclipped context becomes stale.
 SubscribeRequestSchema, UnsubscribeRequestSchema, } from "@modelcontextprotocol/sdk/types.js";
-import { SERVER_CONFIG, SESSION_MEMORY_ENABLED, PRISM_USER_ID } from "./config.js";
+import { SERVER_CONFIG, SESSION_MEMORY_ENABLED, PRISM_USER_ID, debug } from "./config.js";
 import { getSyncBus } from "./sync/factory.js";
 import { startDashboardServer } from "./dashboard/server.js";
 // ─── v2.3.6 FIX: Use Storage Abstraction for Prompts/Resources ───
@@ -147,7 +147,7 @@ const activeSubscriptions = new Set();
 export function notifyResourceUpdate(project, server) {
     const uri = `memory://${project}/handoff`;
     if (activeSubscriptions.has(uri)) {
-        console.error(`[resource-subscription] Notifying update for ${uri}`);
+        debug(`[resource-subscription] Notifying update for ${uri}`);
         server.notification({
             method: "notifications/resources/updated",
             params: { uri },
@@ -165,8 +165,8 @@ export function notifyResourceUpdate(project, server) {
  *                with subscribe support for live refresh
  */
 export function createServer() {
-    console.error(`Creating Prism MCP server v${SERVER_CONFIG.version}`);
-    console.error(`Registering ${ALL_TOOLS.length} tools (${BASE_TOOLS.length} base + ${SESSION_MEMORY_ENABLED ? SESSION_MEMORY_TOOLS.length : 0} session memory)`);
+    debug(`Creating Prism MCP server v${SERVER_CONFIG.version}`);
+    debug(`Registering ${ALL_TOOLS.length} tools (${BASE_TOOLS.length} base + ${SESSION_MEMORY_ENABLED ? SESSION_MEMORY_TOOLS.length : 0} session memory)`);
     const server = new Server({
         name: SERVER_CONFIG.name,
         version: SERVER_CONFIG.version,
@@ -196,7 +196,7 @@ export function createServer() {
     // REVIEWER NOTE: The initialize handler is unchanged from v0.3.0
     // except that it now reports the expanded capabilities.
     server.setRequestHandler(InitializeRequestSchema, async (request) => {
-        console.error(`Client connected: ${request.params.clientInfo?.name || 'unknown'}`);
+        debug(`Client connected: ${request.params.clientInfo?.name || 'unknown'}`);
         return {
             protocolVersion: request.params.protocolVersion,
             serverInfo: {
@@ -214,7 +214,7 @@ export function createServer() {
     });
     // ── Handler: List Tools ──
     server.setRequestHandler(ListToolsRequestSchema, async () => {
-        console.error("Received list tools request");
+        debug("Received list tools request");
         return {
             tools: ALL_TOOLS,
         };
@@ -271,7 +271,7 @@ export function createServer() {
             }
             const project = promptArgs?.project || "default";
             const level = promptArgs?.level || "standard";
-            console.error(`[prompt:resume_session] Loading ${level} context for "${project}"`);
+            debug(`[prompt:resume_session] Loading ${level} context for "${project}"`);
             // v2.3.6 FIX: Use storage abstraction instead of direct supabaseRpc
             const storage = await getStorage();
             const result = await storage.loadContext(project, level, PRISM_USER_ID);
@@ -365,7 +365,7 @@ export function createServer() {
                 throw new Error(`Unknown resource URI: ${uri}. Expected format: memory://{project}/handoff`);
             }
             const project = decodeURIComponent(match[1]);
-            console.error(`[resource:read] Fetching handoff for "${project}"`);
+            debug(`[resource:read] Fetching handoff for "${project}"`);
             try {
                 // v2.3.6 FIX: Use storage abstraction instead of direct supabaseRpc
                 const storage = await getStorage();
@@ -404,13 +404,13 @@ export function createServer() {
         // for projects the client hasn't attached.
         server.setRequestHandler(SubscribeRequestSchema, async (request) => {
             const uri = request.params.uri;
-            console.error(`[resource-subscription] Client subscribed to ${uri}`);
+            debug(`[resource-subscription] Client subscribed to ${uri}`);
             activeSubscriptions.add(uri);
             return {};
         });
         server.setRequestHandler(UnsubscribeRequestSchema, async (request) => {
             const uri = request.params.uri;
-            console.error(`[resource-subscription] Client unsubscribed from ${uri}`);
+            debug(`[resource-subscription] Client unsubscribed from ${uri}`);
             activeSubscriptions.delete(uri);
             return {};
         });
@@ -422,13 +422,13 @@ export function createServer() {
     // The server reference is passed to sessionSaveHandoffHandler so it
     // can trigger resource update notifications on successful saves.
     server.setRequestHandler(CallToolRequestSchema, async (request) => {
-        console.error(`Tool call: ${request.params.name}`);
+        debug(`Tool call: ${request.params.name}`);
         try {
             const { name, arguments: args } = request.params;
             if (!args) {
                 throw new Error("No arguments provided");
             }
-            console.error(`Processing ${name} with arguments: ${JSON.stringify(args)}`);
+            debug(`Processing ${name} with arguments: ${JSON.stringify(args)}`);
             switch (name) {
                 // ── Search & Analysis Tools (always available) ──
                 case "brave_web_search":
@@ -595,11 +595,11 @@ export function createSandboxServer() {
  * responses to stdout. Log messages go to stderr.
  */
 export async function startServer() {
-    console.error("Initializing Prism MCP server...");
+    debug("Initializing Prism MCP server...");
     const server = createServer();
-    console.error("Creating stdio transport...");
+    debug("Creating stdio transport...");
     const transport = new StdioServerTransport();
-    console.error("Connecting server to transport...");
+    debug("Connecting server to transport...");
     await server.connect(transport);
     // ─── v2.0 Step 6: Initialize SyncBus (Telepathy) ───
     if (SESSION_MEMORY_ENABLED) {
@@ -607,7 +607,7 @@ export async function startServer() {
             const syncBus = await getSyncBus();
             await syncBus.startListening();
             syncBus.on("update", (event) => {
-                console.error(`[Telepathy] Memory for project '${event.project}' ` +
+                debug(`[Telepathy] Memory for project '${event.project}' ` +
                     `updated to v${event.version} by another agent!`);
                 // Send an MCP logging notification to the IDE
                 try {
@@ -622,7 +622,7 @@ export async function startServer() {
                     console.error(`[Telepathy] Failed to send notification: ${err}`);
                 }
             });
-            console.error("[Telepathy] SyncBus active — multi-client sync enabled");
+            debug("[Telepathy] SyncBus active — multi-client sync enabled");
         }
         catch (err) {
             console.error(`[Telepathy] SyncBus init failed (non-fatal): ${err}`);
@@ -632,7 +632,7 @@ export async function startServer() {
     startDashboardServer().catch(err => {
         console.error(`[Dashboard] Mind Palace startup failed (non-fatal): ${err}`);
     });
-    console.error(`Prism MCP Server v${SERVER_CONFIG.version} running on stdio`);
+    debug(`Prism MCP Server v${SERVER_CONFIG.version} running on stdio`);
     // Keep the process alive — without this, Node.js would exit
     // because there are no active event loop handles after the
     // synchronous setup completes.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "prism-mcp-server",
-  "version": "2.3.7",
+  "version": "2.3.9",
   "mcpName": "io.github.dcostenco/prism-mcp",
   "description": "The Mind Palace for AI Agents — local-first MCP server with persistent memory (SQLite/Supabase), visual dashboard, time travel, multi-agent sync, Morning Briefings, reality drift detection, code mode templates, semantic vector search, and Brave Search + Gemini analysis. Zero-config local mode.",
   "module": "index.ts",