mindgraph-mcp 0.18.0 → 0.19.0

package/dist/index.js

@@ -2110,7 +2110,7 @@ function renderSignals(response) {
 var TOOLS = [
   {
     name: "mindgraph_capture",
-    description: "Capture knowledge into the graph. Use 'entity' for people/orgs/places/events/nations/concepts (auto-deduplicates \u2014 safe to call even if already exists), 'observation' for factual statements, 'source' for documents/URLs, 'snippet' for quotes from a source, and 'concept' for abstract ideas. Use 'journal' for quick personal notes and 'lesson' for a durable learning attributable to a session or source nodes. Prefer 'entity'/'observation' for objective facts, 'journal' for informal notes, and 'lesson' only for reusable knowledge.",
+    description: "Capture knowledge into the graph. Use 'entity' for people/orgs/places/events/nations/concepts (auto-deduplicates \u2014 safe to call even if already exists), 'observation' for factual statements, 'source' for documents/URLs, 'snippet' for quotes from a source, and 'concept' for abstract ideas. Use 'journal' for quick personal notes, 'lesson' for a durable learning, and 'skill' for a reusable procedure authored from completed work. Skill capture always creates a candidate requiring admin review; it never publishes. Skill names must be 1-64 lowercase a-z, digits, or hyphens, with no leading/trailing/consecutive hyphens and no 'anthropic' or 'claude'. Provide at least one provenance field and write instructions, not a transcript dump.",
     inputSchema: {
       type: "object",
       properties: {
@@ -2123,7 +2123,8 @@ var TOOLS = [
             "snippet",
             "concept",
             "journal",
-            "lesson"
+            "lesson",
+            "skill"
           ],
           description: "Type of knowledge to capture"
         },
@@ -2137,11 +2138,30 @@ var TOOLS = [
         },
         content: {
           type: "string",
-          description: "Journal content/body text (for action=journal)"
+          maxLength: 65536,
+          description: "Journal body (action=journal) or complete SKILL.md instructions, at most 64 KiB UTF-8 (action=skill)"
+        },
+        name: {
+          type: "string",
+          minLength: 1,
+          maxLength: 64,
+          pattern: "^(?!.*(?:anthropic|claude))(?!-)(?!.*--)[a-z0-9](?:[a-z0-9-]{0,62}[a-z0-9])?$",
+          description: "Stable skill identifier using lowercase a-z, digits, and hyphens (for action=skill)"
+        },
+        description: {
+          type: "string",
+          minLength: 1,
+          maxLength: 1024,
+          description: "When the skill should be used; XML tags are rejected (for action=skill)"
+        },
+        license: {
+          type: "string",
+          description: "Optional skill license (for action=skill)"
         },
         session_uid: {
           type: "string",
-          description: "Session UID that produced a lesson (for action=lesson)"
+          minLength: 1,
+          description: "Session UID that produced a lesson or skill"
         },
         work_uid: {
           type: "string",
@@ -2162,7 +2182,8 @@ var TOOLS = [
         summarizes_uids: {
           type: "array",
           items: { type: "string" },
-          description: "Source node UIDs the lesson was learned from (for action=lesson)"
+          minItems: 1,
+          description: "Source node UIDs the lesson or skill was learned from"
         },
         entity_type: {
           type: "string",
@@ -2229,7 +2250,24 @@ var TOOLS = [
           description: "Agent identity"
         }
       },
-      required: ["action", "label"]
+      required: ["action", "label"],
+      allOf: [
+        {
+          if: {
+            properties: { action: { const: "skill" } },
+            required: ["action"]
+          },
+          then: {
+            required: ["name", "description", "content"],
+            anyOf: [
+              { required: ["session_uid"] },
+              { required: ["work_uid"] },
+              { required: ["execution_uid"] },
+              { required: ["summarizes_uids"] }
+            ]
+          }
+        }
+      ]
     }
   },
   {
@@ -2815,6 +2853,42 @@ var TOOLS = [
       required: ["action"]
     }
   },
+  {
+    name: "mindgraph_series_query",
+    description: "Read dense numeric time series without placing raw points in general retrieval context. Use list_for_entity to discover series, latest for cached statistics, window for [from,to) keyset pages, and aggregate for bounded calendar buckets.",
+    inputSchema: {
+      type: "object",
+      additionalProperties: false,
+      properties: {
+        action: {
+          type: "string",
+          enum: ["list_for_entity", "latest", "window", "aggregate"]
+        },
+        entity_uid: { type: "string" },
+        series_uid: { type: "string" },
+        from: { type: "number" },
+        to: { type: "number" },
+        cursor: { type: "number" },
+        limit: { type: "number", minimum: 1, maximum: 1e4 },
+        bucket: {
+          type: "string",
+          enum: ["year", "quarter", "month", "week", "day", "hour"]
+        },
+        agg: {
+          type: "string",
+          enum: ["sum", "mean", "min", "max", "count", "std_dev", "last"]
+        },
+        fill: { type: "string", enum: ["none", "null", "prev"] }
+      },
+      required: ["action"]
+    },
+    annotations: {
+      readOnlyHint: true,
+      destructiveHint: false,
+      idempotentHint: true,
+      openWorldHint: false
+    }
+  },
   {
     name: "mindgraph_ingest",
     description: "Ingest long-form content (articles, transcripts, documents, meeting notes) into the knowledge graph. The pipeline automatically chunks the text, extracts entities/claims/relationships via LLM, and deduplicates against existing nodes. Use 'chunk' for a single passage (synchronous), 'document' for full documents (async \u2014 returns a job ID), 'session' for conversation transcripts. Use 'job_status' to check progress. For short individual facts, use the specific cognitive tools instead.",
@@ -3147,6 +3221,9 @@ async function handleTool(client2, name, args) {
       case "mindgraph_retrieve":
         result = await handleRetrieve(client2, args);
         break;
+      case "mindgraph_series_query":
+        result = await handleSeriesQuery(client2, args);
+        break;
       case "mindgraph_ingest":
         result = await handleIngest(client2, args);
         break;
@@ -3191,12 +3268,36 @@ async function handleTool(client2, name, args) {
     return err3(errorDetail(e));
   }
 }
+async function handleSeriesQuery(client2, args) {
+  const action = typeof args.action === "string" ? args.action : "";
+  if (!["list_for_entity", "latest", "window", "aggregate"].includes(action)) {
+    return err3(`Unknown series query action: ${action}`);
+  }
+  if (action === "list_for_entity" && typeof args.entity_uid !== "string") {
+    return err3("entity_uid is required for action='list_for_entity'");
+  }
+  if (action !== "list_for_entity" && typeof args.series_uid !== "string") {
+    return err3(`series_uid is required for action='${action}'`);
+  }
+  if ((action === "window" || action === "aggregate") && (typeof args.from !== "number" || typeof args.to !== "number")) {
+    return err3(`from and to are required for action='${action}'`);
+  }
+  if (action === "aggregate" && (typeof args.bucket !== "string" || typeof args.agg !== "string")) {
+    return err3("bucket and agg are required for action='aggregate'");
+  }
+  return ok3(
+    await client2.series(args)
+  );
+}
 async function handleCapture(client2, args) {
   const {
     action,
     label,
     summary,
     content,
+    name,
+    description,
+    license,
     session_uid,
     work_uid,
     execution_uid,
@@ -3231,6 +3332,41 @@ async function handleCapture(client2, args) {
           agent_id
         })
       );
+    case "skill": {
+      if (!name) return err3("name is required for action=skill");
+      if (!description) return err3("description is required for action=skill");
+      if (content === void 0) return err3("content is required for action=skill");
+      const hasProvenance = [session_uid, work_uid, execution_uid].some(
+        (uid) => typeof uid === "string" && uid.length > 0
+      ) || Array.isArray(summarizes_uids) && summarizes_uids.some((uid) => typeof uid === "string" && uid.length > 0);
+      if (!hasProvenance) {
+        return err3(
+          "at least one of session_uid, work_uid, execution_uid, or summarizes_uids is required for action=skill"
+        );
+      }
+      return ok3(
+        await client2.distill({
+          label,
+          output_type: "skill",
+          summary,
+          confidence,
+          salience,
+          session_uid,
+          work_uid,
+          execution_uid,
+          idempotency_key,
+          supersedes_uid,
+          summarizes_uids,
+          props: {
+            name,
+            description,
+            content,
+            ...license ? { license } : {}
+          },
+          agent_id
+        })
+      );
+    }
     case "journal": {
       if (!content) return err3("content is required for action=journal");
       const journalProps = { content };
@@ -4434,6 +4570,7 @@ var ONTOLOGY_READ_ACTIONS = /* @__PURE__ */ new Set([
 ]);
 function toolMutability(toolName, action) {
   if (toolName === "mindgraph_retrieve") return "read";
+  if (toolName === "mindgraph_series_query") return "read";
   if (toolName === "mindgraph_plan") {
     return action && PLAN_READ_ACTIONS.has(action) ? "read" : "write";
   }
@@ -4460,6 +4597,8 @@ function toolMutability(toolName, action) {
 var UID_FIELDS = [
   "uid",
   "source_uid",
+  "entity_uid",
+  "series_uid",
   "session_uid",
   "work_uid",
   "goal_uid",
@@ -5070,7 +5209,7 @@ if (PROFILE === "coding") {
 }
 var RUNNER_REFRESH = (() => {
   try {
-    return refreshHookRunner("0.18.0", import_node_path5.default.join(__dirname, "cli.js"));
+    return refreshHookRunner("0.19.0", import_node_path5.default.join(__dirname, "cli.js"));
   } catch {
     return void 0;
   }
@@ -5084,12 +5223,12 @@ if (RUNNER_REFRESH?.refreshed) {
     }
   })();
   console.error(
-    `[mindgraph-mcp] refreshed pinned hook runner ${RUNNER_REFRESH.runnerVersion ? `v${RUNNER_REFRESH.runnerVersion}` : "(pre-sidecar)"} \u2192 v${"0.18.0"}` + (refreshedSettings.length > 0 ? `; refreshed owned hook entries in ${refreshedSettings.join(", ")}` : "")
+    `[mindgraph-mcp] refreshed pinned hook runner ${RUNNER_REFRESH.runnerVersion ? `v${RUNNER_REFRESH.runnerVersion}` : "(pre-sidecar)"} \u2192 v${"0.19.0"}` + (refreshedSettings.length > 0 ? `; refreshed owned hook entries in ${refreshedSettings.join(", ")}` : "")
   );
 }
 var HOOK_SKEW_NOTE = (() => {
   try {
-    return versionSkewNote("0.18.0");
+    return versionSkewNote("0.19.0");
   } catch {
     return void 0;
   }
@@ -5103,7 +5242,7 @@ ${HOOK_SKEW_NOTE}`;
 var server = new import_server.Server(
   {
     name: "mindgraph",
-    version: "0.18.0"
+    version: "0.19.0"
   },
   {
     capabilities: {
@@ -5317,7 +5456,7 @@ async function main() {
   const transport = new import_stdio.StdioServerTransport();
   await server.connect(transport);
   console.error(
-    `MindGraph MCP server v${"0.18.0"} running on stdio (${BASE_URL})`
+    `MindGraph MCP server v${"0.19.0"} running on stdio (${BASE_URL})`
   );
 }
 main().catch((error) => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mindgraph-mcp",
-  "version": "0.18.0",
+  "version": "0.19.0",
   "description": "MCP server for MindGraph — connect Claude Desktop, Claude Code, and any MCP client to your knowledge graph",
   "repository": {
     "type": "git",
@@ -32,7 +32,7 @@
   "license": "MIT",
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.12.1",
-    "mindgraph": "^0.14.0"
+    "mindgraph": "^0.15.0"
   },
   "devDependencies": {
     "@types/node": "^22.0.0",