mindgraph-mcp 0.23.0 → 0.25.0

package/dist/server.d.mts

@@ -1,6 +1,5 @@
-import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import { Tool, Server } from '@modelcontextprotocol/server';
 import { MindGraph } from 'mindgraph';
-import { Tool } from '@modelcontextprotocol/sdk/types.js';
 
 interface GeneratedToolDescriptor {
     name: string;
@@ -77,6 +76,10 @@ interface MemoryRuntimeConfig {
 /** Everything the request handlers close over. */
 interface ServerWiring {
     client: MindGraph;
+    /** Fields a local harness hook recorded for a call (see call-ledger.ts).
+     * Injected by the stdio entry so this module stays free of node:fs for the
+     * hosted bundle. */
+    resolveHookFields?: (name: string, args: Record<string, unknown>) => Record<string, unknown> | undefined;
     serverVersion: string;
     instructions: string;
     profile: string;
@@ -126,7 +129,9 @@ declare function createMindGraphServer(opts: MindGraphServerOptions): Server;
 /**
  * Serve one Streamable HTTP request statelessly (D6). The caller has already
  * verified the bearer and resolved `opts`; this helper owns only the JSON-RPC
- * surface: non-POST → 405, unparsable → 400, batches → 400, else the SDK.
+ * surface: non-POST → 405, unparsable → 400, batches → 400, else the SDK —
+ * the 2026-07-28 path for requests that carry the per-request envelope, the
+ * 2025 stateless path for every other client.
  */
 declare function handleHostedRequest(request: Request, opts: MindGraphServerOptions): Promise<Response>;
 

package/dist/server.d.ts

@@ -1,6 +1,5 @@
-import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import { Tool, Server } from '@modelcontextprotocol/server';
 import { MindGraph } from 'mindgraph';
-import { Tool } from '@modelcontextprotocol/sdk/types.js';
 
 interface GeneratedToolDescriptor {
     name: string;
@@ -77,6 +76,10 @@ interface MemoryRuntimeConfig {
 /** Everything the request handlers close over. */
 interface ServerWiring {
     client: MindGraph;
+    /** Fields a local harness hook recorded for a call (see call-ledger.ts).
+     * Injected by the stdio entry so this module stays free of node:fs for the
+     * hosted bundle. */
+    resolveHookFields?: (name: string, args: Record<string, unknown>) => Record<string, unknown> | undefined;
     serverVersion: string;
     instructions: string;
     profile: string;
@@ -126,7 +129,9 @@ declare function createMindGraphServer(opts: MindGraphServerOptions): Server;
 /**
  * Serve one Streamable HTTP request statelessly (D6). The caller has already
  * verified the bearer and resolved `opts`; this helper owns only the JSON-RPC
- * surface: non-POST → 405, unparsable → 400, batches → 400, else the SDK.
+ * surface: non-POST → 405, unparsable → 400, batches → 400, else the SDK —
+ * the 2026-07-28 path for requests that carry the per-request envelope, the
+ * 2025 stateless path for every other client.
  */
 declare function handleHostedRequest(request: Request, opts: MindGraphServerOptions): Promise<Response>;
 

package/dist/server.js

@@ -35,9 +35,7 @@ __export(server_exports, {
   handleHostedRequest: () => handleHostedRequest
 });
 module.exports = __toCommonJS(server_exports);
-var import_server = require("@modelcontextprotocol/sdk/server/index.js");
-var import_webStandardStreamableHttp = require("@modelcontextprotocol/sdk/server/webStandardStreamableHttp.js");
-var import_types = require("@modelcontextprotocol/sdk/types.js");
+var import_server = require("@modelcontextprotocol/server");
 
 // src/error-detail.ts
 var import_mindgraph = require("mindgraph");
@@ -331,6 +329,14 @@ function hiddenSections(payload) {
 function renderContext(response, maxChars) {
   const payload = obj(response);
   if (!payload) return void 0;
+  if (typeof payload.context_text === "string" && payload.context_text.length > 0) {
+    const text2 = payload.context_text;
+    if (maxChars !== void 0 && text2.length > maxChars) {
+      return `${text2.slice(0, maxChars)}
+[truncated to ${maxChars} characters]`;
+    }
+    return text2;
+  }
   const graph = obj(payload.graph);
   const rawNodes = Array.isArray(graph?.nodes) ? graph.nodes : [];
   const shaped = rawNodes.filter(isNodeShaped);
@@ -4465,6 +4471,15 @@ var TOOLS = [
           type: "string",
           description: "ISO-8601 date (e.g. '2021-06') for context: nodes with validity windows are annotated as of this date instead of today"
         },
+        as_of: {
+          type: "string",
+          description: "ISO-8601 date for context: answer with what had been STATED by this date (a node is admitted when one of its sources was stated on or before it; fact dates never exclude it). Use for 'what did we know / what was the value as of <date>' questions."
+        },
+        retrieval_mode: {
+          type: "string",
+          enum: ["normal", "exhaustive"],
+          description: "context: 'exhaustive' widens retrieval for list/count questions ('how many different \u2026 across', 'what two \u2026'); omitted lets the server's cue decide."
+        },
         created_after: {
           type: "number",
           description: "Unix seconds \u2014 'recent' action: only nodes ingested after this time"
@@ -5693,6 +5708,8 @@ async function handleRetrieve(client, args, profile) {
     salience_min,
     article_limit,
     valid_at,
+    as_of,
+    retrieval_mode,
     created_after,
     created_before,
     explain,
@@ -5721,9 +5738,15 @@ async function handleRetrieve(client, args, profile) {
           // the advertised knob must not get a silent no-op).
           ...article_limit !== void 0 ? { article_limit } : include_documents === false || profile === "coding" && !include_documents ? { article_limit: 0 } : {},
           valid_at,
+          as_of,
+          retrieval_mode,
           include_graph,
           graph_expansion_limit: graph_expansion_limit ?? 3,
-          graph_max_depth: graph_max_depth ?? 2
+          graph_max_depth: graph_max_depth ?? 2,
+          // Evidence plan R2: the server's canonical rendering under a token
+          // budget derived from the character budget; the local renderer is
+          // the fallback for servers that predate it.
+          ...format === "json" ? {} : { format: "text", max_tokens: Math.max(256, Math.floor((max_output_chars ?? 24e3) / 4)) }
         }),
         (raw) => renderContext(raw, max_output_chars)
       );
@@ -6184,7 +6207,7 @@ function buildMindGraphServer(wiring) {
       instructions: wiring.instructions
     }
   );
-  server.setRequestHandler(import_types.ListToolsRequestSchema, async () => {
+  server.setRequestHandler("tools/list", async () => {
     const generated = await getGeneratedTools(client, wiring.generatedTools);
     const tools = [...toolsForProfile(wiring.profile), ...generated.tools];
     if (!hosted) return { tools };
@@ -6195,9 +6218,14 @@ function buildMindGraphServer(wiring) {
       ]
     };
   });
-  server.setRequestHandler(import_types.CallToolRequestSchema, async (request) => {
+  server.setRequestHandler("tools/call", async (request) => {
     const { name, arguments: args } = request.params;
-    const rawArgs = { ...args || {} };
+    const rawArgs = {
+      ...args || {},
+      // H1: session, lease and invocation fields the local hook recorded for
+      // this exact call (stdio only; hosted mode has no local hook).
+      ...hosted ? {} : wiring.resolveHookFields?.(name, args || {})
+    };
     const toolArgs = { ...rawArgs };
     let governanceConfig = wiring.governance;
     if (hosted) {
@@ -6237,20 +6265,20 @@ function buildMindGraphServer(wiring) {
     }
     return handleTool(client, name, toolArgs, wiring.memory);
   });
-  server.setRequestHandler(import_types.ListPromptsRequestSchema, async () => {
+  server.setRequestHandler("prompts/list", async () => {
     return { prompts: PROMPTS };
   });
-  server.setRequestHandler(import_types.GetPromptRequestSchema, async (request) => {
+  server.setRequestHandler("prompts/get", async (request) => {
     const { name, arguments: args } = request.params;
     return getPrompt(name, args);
   });
-  server.setRequestHandler(import_types.ListResourcesRequestSchema, async () => {
+  server.setRequestHandler("resources/list", async () => {
     return { resources: RESOURCES };
   });
-  server.setRequestHandler(import_types.ListResourceTemplatesRequestSchema, async () => {
+  server.setRequestHandler("resources/templates/list", async () => {
     return { resourceTemplates: RESOURCE_TEMPLATES };
   });
-  server.setRequestHandler(import_types.ReadResourceRequestSchema, async (request) => {
+  server.setRequestHandler("resources/read", async (request) => {
     return readGovernedResource(
       client,
       request.params.uri,
@@ -6316,8 +6344,21 @@ async function handleHostedRequest(request, opts) {
   if (Array.isArray(parsedBody)) {
     return jsonRpcError(400, -32600, "JSON-RPC batches are not accepted");
   }
+  if (!await (0, import_server.isLegacyRequest)(request, parsedBody)) {
+    const modern = (0, import_server.createMcpHandler)(() => createMindGraphServer(opts), {
+      legacy: "reject"
+      // Default response mode: one JSON body unless a handler emits a message
+      // before its result. No tool does today; a tool that starts emitting
+      // progress must also stop this function closing the handler on return.
+    });
+    try {
+      return await modern.fetch(request, { parsedBody });
+    } finally {
+      await modern.close();
+    }
+  }
   const server = createMindGraphServer(opts);
-  const transport = new import_webStandardStreamableHttp.WebStandardStreamableHTTPServerTransport({
+  const transport = new import_server.WebStandardStreamableHTTPServerTransport({
     sessionIdGenerator: void 0,
     enableJsonResponse: true
   });

package/dist/server.mjs

@@ -1,15 +1,10 @@
 // src/server.ts
-import { Server } from "@modelcontextprotocol/sdk/server/index.js";
-import { WebStandardStreamableHTTPServerTransport } from "@modelcontextprotocol/sdk/server/webStandardStreamableHttp.js";
 import {
-  CallToolRequestSchema,
-  GetPromptRequestSchema,
-  ListPromptsRequestSchema,
-  ListResourcesRequestSchema,
-  ListResourceTemplatesRequestSchema,
-  ListToolsRequestSchema,
-  ReadResourceRequestSchema
-} from "@modelcontextprotocol/sdk/types.js";
+  createMcpHandler,
+  isLegacyRequest,
+  Server,
+  WebStandardStreamableHTTPServerTransport
+} from "@modelcontextprotocol/server";
 
 // src/error-detail.ts
 import { MindGraphError } from "mindgraph";
@@ -303,6 +298,14 @@ function hiddenSections(payload) {
 function renderContext(response, maxChars) {
   const payload = obj(response);
   if (!payload) return void 0;
+  if (typeof payload.context_text === "string" && payload.context_text.length > 0) {
+    const text2 = payload.context_text;
+    if (maxChars !== void 0 && text2.length > maxChars) {
+      return `${text2.slice(0, maxChars)}
+[truncated to ${maxChars} characters]`;
+    }
+    return text2;
+  }
   const graph = obj(payload.graph);
   const rawNodes = Array.isArray(graph?.nodes) ? graph.nodes : [];
   const shaped = rawNodes.filter(isNodeShaped);
@@ -4452,6 +4455,15 @@ var TOOLS = [
           type: "string",
           description: "ISO-8601 date (e.g. '2021-06') for context: nodes with validity windows are annotated as of this date instead of today"
         },
+        as_of: {
+          type: "string",
+          description: "ISO-8601 date for context: answer with what had been STATED by this date (a node is admitted when one of its sources was stated on or before it; fact dates never exclude it). Use for 'what did we know / what was the value as of <date>' questions."
+        },
+        retrieval_mode: {
+          type: "string",
+          enum: ["normal", "exhaustive"],
+          description: "context: 'exhaustive' widens retrieval for list/count questions ('how many different \u2026 across', 'what two \u2026'); omitted lets the server's cue decide."
+        },
         created_after: {
           type: "number",
           description: "Unix seconds \u2014 'recent' action: only nodes ingested after this time"
@@ -5680,6 +5692,8 @@ async function handleRetrieve(client, args, profile) {
     salience_min,
     article_limit,
     valid_at,
+    as_of,
+    retrieval_mode,
     created_after,
     created_before,
     explain,
@@ -5708,9 +5722,15 @@ async function handleRetrieve(client, args, profile) {
           // the advertised knob must not get a silent no-op).
           ...article_limit !== void 0 ? { article_limit } : include_documents === false || profile === "coding" && !include_documents ? { article_limit: 0 } : {},
           valid_at,
+          as_of,
+          retrieval_mode,
           include_graph,
           graph_expansion_limit: graph_expansion_limit ?? 3,
-          graph_max_depth: graph_max_depth ?? 2
+          graph_max_depth: graph_max_depth ?? 2,
+          // Evidence plan R2: the server's canonical rendering under a token
+          // budget derived from the character budget; the local renderer is
+          // the fallback for servers that predate it.
+          ...format === "json" ? {} : { format: "text", max_tokens: Math.max(256, Math.floor((max_output_chars ?? 24e3) / 4)) }
         }),
         (raw) => renderContext(raw, max_output_chars)
       );
@@ -6171,7 +6191,7 @@ function buildMindGraphServer(wiring) {
       instructions: wiring.instructions
     }
   );
-  server.setRequestHandler(ListToolsRequestSchema, async () => {
+  server.setRequestHandler("tools/list", async () => {
     const generated = await getGeneratedTools(client, wiring.generatedTools);
     const tools = [...toolsForProfile(wiring.profile), ...generated.tools];
     if (!hosted) return { tools };
@@ -6182,9 +6202,14 @@ function buildMindGraphServer(wiring) {
       ]
     };
   });
-  server.setRequestHandler(CallToolRequestSchema, async (request) => {
+  server.setRequestHandler("tools/call", async (request) => {
     const { name, arguments: args } = request.params;
-    const rawArgs = { ...args || {} };
+    const rawArgs = {
+      ...args || {},
+      // H1: session, lease and invocation fields the local hook recorded for
+      // this exact call (stdio only; hosted mode has no local hook).
+      ...hosted ? {} : wiring.resolveHookFields?.(name, args || {})
+    };
     const toolArgs = { ...rawArgs };
     let governanceConfig = wiring.governance;
     if (hosted) {
@@ -6224,20 +6249,20 @@ function buildMindGraphServer(wiring) {
     }
     return handleTool(client, name, toolArgs, wiring.memory);
   });
-  server.setRequestHandler(ListPromptsRequestSchema, async () => {
+  server.setRequestHandler("prompts/list", async () => {
     return { prompts: PROMPTS };
   });
-  server.setRequestHandler(GetPromptRequestSchema, async (request) => {
+  server.setRequestHandler("prompts/get", async (request) => {
     const { name, arguments: args } = request.params;
     return getPrompt(name, args);
   });
-  server.setRequestHandler(ListResourcesRequestSchema, async () => {
+  server.setRequestHandler("resources/list", async () => {
     return { resources: RESOURCES };
   });
-  server.setRequestHandler(ListResourceTemplatesRequestSchema, async () => {
+  server.setRequestHandler("resources/templates/list", async () => {
     return { resourceTemplates: RESOURCE_TEMPLATES };
   });
-  server.setRequestHandler(ReadResourceRequestSchema, async (request) => {
+  server.setRequestHandler("resources/read", async (request) => {
     return readGovernedResource(
       client,
       request.params.uri,
@@ -6303,6 +6328,19 @@ async function handleHostedRequest(request, opts) {
   if (Array.isArray(parsedBody)) {
     return jsonRpcError(400, -32600, "JSON-RPC batches are not accepted");
   }
+  if (!await isLegacyRequest(request, parsedBody)) {
+    const modern = createMcpHandler(() => createMindGraphServer(opts), {
+      legacy: "reject"
+      // Default response mode: one JSON body unless a handler emits a message
+      // before its result. No tool does today; a tool that starts emitting
+      // progress must also stop this function closing the handler on return.
+    });
+    try {
+      return await modern.fetch(request, { parsedBody });
+    } finally {
+      await modern.close();
+    }
+  }
   const server = createMindGraphServer(opts);
   const transport = new WebStandardStreamableHTTPServerTransport({
     sessionIdGenerator: void 0,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mindgraph-mcp",
-  "version": "0.23.0",
+  "version": "0.25.0",
   "description": "MCP server for MindGraph \u2014 connect Claude Desktop, Claude Code, and any MCP client to your knowledge graph",
   "repository": {
     "type": "git",
@@ -42,11 +42,15 @@
     "agent"
   ],
   "license": "MIT",
+  "engines": {
+    "node": ">=20"
+  },
   "dependencies": {
-    "@modelcontextprotocol/sdk": "^1.25.0",
-    "mindgraph": "^0.16.0"
+    "@modelcontextprotocol/server": "^2.4.0",
+    "mindgraph": "^0.17.0"
   },
   "devDependencies": {
+    "@modelcontextprotocol/client": "^2.4.0",
     "@types/node": "^22.0.0",
     "tsup": "^8.0.0",
     "typescript": "^5.7.0",