mindgraph-mcp 0.23.0 → 0.24.0

package/dist/server.d.mts

@@ -77,6 +77,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;

package/dist/server.d.ts

@@ -77,6 +77,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;

package/dist/server.js

@@ -331,6 +331,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 +4473,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 +5710,8 @@ async function handleRetrieve(client, args, profile) {
     salience_min,
     article_limit,
     valid_at,
+    as_of,
+    retrieval_mode,
     created_after,
     created_before,
     explain,
@@ -5721,9 +5740,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)
       );
@@ -6197,7 +6222,12 @@ function buildMindGraphServer(wiring) {
   });
   server.setRequestHandler(import_types.CallToolRequestSchema, 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) {

package/dist/server.mjs

@@ -303,6 +303,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 +4460,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 +5697,8 @@ async function handleRetrieve(client, args, profile) {
     salience_min,
     article_limit,
     valid_at,
+    as_of,
+    retrieval_mode,
     created_after,
     created_before,
     explain,
@@ -5708,9 +5727,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 +6209,12 @@ function buildMindGraphServer(wiring) {
   });
   server.setRequestHandler(CallToolRequestSchema, 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) {

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "mindgraph-mcp",
-  "version": "0.23.0",
-  "description": "MCP server for MindGraph \u2014 connect Claude Desktop, Claude Code, and any MCP client to your knowledge graph",
+  "version": "0.24.0",
+  "description": "MCP server for MindGraph — connect Claude Desktop, Claude Code, and any MCP client to your knowledge graph",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/shuruheel/mindgraph-mcp.git"
@@ -44,7 +44,7 @@
   "license": "MIT",
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.25.0",
-    "mindgraph": "^0.16.0"
+    "mindgraph": "^0.17.0"
   },
   "devDependencies": {
     "@types/node": "^22.0.0",