midnight-mcp 0.2.6 → 0.2.8

package/README.md

@@ -1,7 +1,7 @@
 # Midnight MCP Server
 
 [![npm version](https://badge.fury.io/js/midnight-mcp.svg)](https://www.npmjs.com/package/midnight-mcp)
-[![npm downloads](https://img.shields.io/npm/dm/midnight-mcp)](https://www.npmjs.com/package/midnight-mcp)
+[![npm downloads](https://img.shields.io/npm/dm/midnight-mcp)](https://npm-stat.com/charts.html?package=midnight-mcp)
 [![License](https://img.shields.io/npm/l/midnight-mcp)](./LICENSE)
 [![TypeScript](https://img.shields.io/badge/TypeScript-5.3-blue?logo=typescript)](https://www.typescriptlang.org/)
 [![CI](https://github.com/Olanetsoft/midnight-mcp/actions/workflows/ci.yml/badge.svg)](https://github.com/Olanetsoft/midnight-mcp/actions/workflows/ci.yml)
@@ -264,4 +264,6 @@ The hosted API runs on Cloudflare Workers + Vectorize. See [api/README.md](./api
 
 MIT
 
-Thanks to all Stargazers ⭐️
+## Stargazers ⭐️
+
+[![Star History Chart](https://api.star-history.com/svg?repos=Olanetsoft/midnight-mcp&type=Date)](https://star-history.com/#Olanetsoft/midnight-mcp&Date)

package/dist/bin.js

@@ -2,10 +2,10 @@
 import {
   startHttpServer,
   startServer
-} from "./chunk-L5CXYFG2.js";
+} from "./chunk-QPQOD3S6.js";
 import {
   setOutputFormat
-} from "./chunk-WC2FPYQO.js";
+} from "./chunk-VQTI7YUU.js";
 
 // src/bin.ts
 import { config } from "dotenv";
@@ -13,7 +13,7 @@ import { resolve } from "path";
 import yargs from "yargs";
 import { hideBin } from "yargs/helpers";
 config({ path: resolve(process.cwd(), ".env") });
-var CURRENT_VERSION = "0.2.6";
+var CURRENT_VERSION = "0.2.8";
 process.on("uncaughtException", (error) => {
   console.error("Uncaught exception:", error);
   process.exit(1);

package/dist/{chunk-L5CXYFG2.js → chunk-QPQOD3S6.js}

@@ -25,7 +25,7 @@ import {
   validateNumber,
   validateQuery,
   vectorStore
-} from "./chunk-WC2FPYQO.js";
+} from "./chunk-VQTI7YUU.js";
 
 // src/tools/search/schemas.ts
 import { z } from "zod";
@@ -794,8 +794,18 @@ async function explainCircuit(input) {
   const circuit = parsed.codeUnits.find((u) => u.type === "circuit");
   if (!circuit) {
     return {
-      error: "No circuit definition found in the provided code",
-      suggestion: "Make sure to provide a complete circuit definition including 'circuit' keyword"
+      circuitName: "unknown",
+      isPublic: false,
+      parameters: [],
+      returnType: "unknown",
+      explanation: "No circuit definition found in the provided code. Make sure to provide a complete circuit definition including the 'circuit' keyword.",
+      operations: [],
+      zkImplications: [
+        "Unable to analyze - no valid circuit found in the provided code"
+      ],
+      privacyConsiderations: [
+        "Provide a complete circuit definition for privacy analysis"
+      ]
     };
   }
   const operations = [];
@@ -1115,7 +1125,13 @@ var GetFileInputSchema = z3.object({
     "Repository name (e.g., 'compact', 'midnight-js', 'example-counter')"
   ),
   path: z3.string().describe("File path within repository"),
-  ref: z3.string().optional().describe("Branch, tag, or commit SHA (default: main)")
+  ref: z3.string().optional().describe("Branch, tag, or commit SHA (default: main)"),
+  startLine: z3.number().int().positive().optional().describe(
+    "Start line number (1-based, inclusive). Use to request specific sections of large files."
+  ),
+  endLine: z3.number().int().positive().optional().describe(
+    "End line number (1-based, inclusive). Use with startLine to get a specific range."
+  )
 });
 var ListExamplesInputSchema = z3.object({
   category: z3.enum(["counter", "bboard", "token", "voting", "all"]).optional().default("all").describe("Filter by example type")
@@ -4530,15 +4546,22 @@ Please help me debug by:
 
 // src/services/sampling.ts
 var samplingCallback = null;
+var samplingFailedPermanently = false;
 function isSamplingAvailable() {
+  if (samplingFailedPermanently) return false;
   return samplingCallback !== null;
 }
+function markSamplingFailed() {
+  samplingFailedPermanently = true;
+  logger.warn("Sampling marked as permanently unavailable for this session");
+}
 function registerSamplingCallback(callback) {
   samplingCallback = callback;
+  samplingFailedPermanently = false;
   logger.info("Sampling capability registered");
 }
 async function requestCompletion(messages, options = {}) {
-  if (!samplingCallback) {
+  if (!samplingCallback || samplingFailedPermanently) {
     throw new Error(
       "Sampling not available - client does not support this capability"
     );
@@ -4561,11 +4584,25 @@ async function requestCompletion(messages, options = {}) {
     messageCount: messages.length,
     maxTokens: request.maxTokens
   });
-  const response = await samplingCallback(request);
-  if (response.content.type !== "text") {
-    throw new Error("Unexpected response content type");
+  try {
+    const response = await samplingCallback(request);
+    if (response.content.type !== "text") {
+      throw new Error("Unexpected response content type");
+    }
+    return response.content.text;
+  } catch (error) {
+    const errorStr = String(error);
+    if (errorStr.includes("-32601") || errorStr.includes("Method not found") || errorStr.includes("not supported")) {
+      logger.warn(
+        "Client does not support sampling/createMessage, disabling sampling for this session"
+      );
+      markSamplingFailed();
+      throw new Error(
+        "Sampling not supported by this client - use Claude Desktop for this feature"
+      );
+    }
+    throw error;
   }
-  return response.content.text;
 }
 async function generateContract(requirements, options = {}) {
   if (!isSamplingAvailable()) {
@@ -5164,6 +5201,17 @@ function registerResourceHandlers(server) {
           "midnight://schema/"
         ];
         const validPrefix = resourceTypes.find((p) => uri.startsWith(p));
+        let suggestion = validPrefix ? `Check the resource path after '${validPrefix}'` : `Valid resource prefixes: ${resourceTypes.join(", ")}`;
+        if (uri.includes("://resources/")) {
+          const resourceName = uri.split("://resources/").pop() || "";
+          if (resourceName.includes("template") || resourceName.includes("pattern") || resourceName.includes("example")) {
+            suggestion = `Try: midnight://code/templates/${resourceName} or midnight://code/examples/${resourceName} or midnight://code/patterns/${resourceName}`;
+          } else if (resourceName.includes("doc") || resourceName.includes("reference") || resourceName.includes("guide")) {
+            suggestion = `Try: midnight://docs/${resourceName}`;
+          } else {
+            suggestion = `'midnight://resources/' is not valid. Use: midnight://docs/, midnight://code/, or midnight://schema/`;
+          }
+        }
         return {
           contents: [
             {
@@ -5171,8 +5219,9 @@ function registerResourceHandlers(server) {
               mimeType: "application/json",
               text: serialize({
                 error: `Resource not found: ${uri}`,
-                suggestion: validPrefix ? `Check the resource path after '${validPrefix}'` : `Valid resource prefixes: ${resourceTypes.join(", ")}`,
-                hint: "Use ListResources to see all available resources"
+                suggestion,
+                hint: "Use ListResources to see all available resources",
+                validPrefixes: resourceTypes
               })
             }
           ]
@@ -6525,8 +6574,112 @@ function resolveRepo(repoName) {
   }
   return null;
 }
+var MAX_FILE_CONTENT_LENGTH = 5e4;
+var TRUNCATION_RATIOS = {
+  compact: { top: 0.8, bottom: 0.2 },
+  // 40KB top, 10KB bottom
+  typescript: { top: 0.5, bottom: 0.5 },
+  // 25KB each
+  javascript: { top: 0.5, bottom: 0.5 },
+  default: { top: 0.6, bottom: 0.4 }
+  // Slight preference for top
+};
+function detectLanguage(filePath) {
+  const ext = filePath.split(".").pop()?.toLowerCase();
+  switch (ext) {
+    case "compact":
+      return "compact";
+    case "ts":
+    case "tsx":
+      return "typescript";
+    case "js":
+    case "jsx":
+    case "mjs":
+      return "javascript";
+    default:
+      return "default";
+  }
+}
+function smartTruncate(content, filePath = "", maxLength = MAX_FILE_CONTENT_LENGTH) {
+  if (content.length <= maxLength) {
+    return { content, truncated: false };
+  }
+  const language = detectLanguage(filePath);
+  const ratio = TRUNCATION_RATIOS[language] || TRUNCATION_RATIOS.default;
+  const lines = content.split("\n");
+  const totalLines = lines.length;
+  const topLength = Math.floor(maxLength * ratio.top);
+  const bottomLength = maxLength - topLength;
+  const firstPart = content.slice(0, topLength);
+  const lastPart = content.slice(-bottomLength);
+  const omittedBytes = content.length - maxLength;
+  const firstPartLines = firstPart.split("\n").length;
+  const lastPartLines = lastPart.split("\n").length;
+  const omittedStartLine = firstPartLines + 1;
+  const omittedEndLine = totalLines - lastPartLines;
+  const languageContext = language === "compact" ? "Compact files: pragma and imports preserved at top (critical for compilation)" : language === "typescript" || language === "javascript" ? "TS/JS files: balanced truncation preserves imports AND exports" : "Balanced truncation applied";
+  const truncatedContent = firstPart + `
+
+/* \u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550
+   CONTENT TRUNCATED: Lines ${omittedStartLine}-${omittedEndLine} omitted (${omittedBytes.toLocaleString()} bytes)
+   ${languageContext}
+   
+   To get the omitted content, call this tool again with:
+   - startLine: ${omittedStartLine}, endLine: ${Math.min(omittedStartLine + 200, omittedEndLine)} (first part of omitted)
+   - startLine: ${Math.max(omittedStartLine, omittedEndLine - 200)}, endLine: ${omittedEndLine} (last part of omitted)
+   
+   Or request the full middle section:
+   - startLine: ${omittedStartLine}, endLine: ${omittedEndLine}
+\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550 */
+
+` + lastPart;
+  return {
+    content: truncatedContent,
+    truncated: true,
+    truncationInfo: {
+      originalSize: content.length,
+      keptBytes: maxLength,
+      omittedBytes,
+      keptLineRanges: [
+        { start: 1, end: firstPartLines },
+        { start: totalLines - lastPartLines + 1, end: totalLines }
+      ],
+      omittedLineRange: { start: omittedStartLine, end: omittedEndLine },
+      language,
+      ratioUsed: ratio
+    },
+    agentGuidance: {
+      whatYouHave: `Lines 1-${firstPartLines} (${Math.round(ratio.top * 100)}% from top) and lines ${totalLines - lastPartLines + 1}-${totalLines} (${Math.round(ratio.bottom * 100)}% from bottom)`,
+      whatIsMissing: `Lines ${omittedStartLine}-${omittedEndLine} (${omittedEndLine - omittedStartLine + 1} lines, ${omittedBytes.toLocaleString()} bytes)`,
+      howToGetMore: [
+        `Call midnight-get-file again with startLine and endLine parameters`,
+        `The omitted content is in the middle of the file`,
+        `You can request it in chunks (e.g., 200 lines at a time) or all at once`
+      ],
+      suggestedNextCalls: [
+        {
+          startLine: omittedStartLine,
+          endLine: Math.min(omittedStartLine + 199, omittedEndLine),
+          reason: "First chunk of omitted content"
+        },
+        ...omittedEndLine - omittedStartLine > 200 ? [
+          {
+            startLine: Math.max(omittedStartLine, omittedEndLine - 199),
+            endLine: omittedEndLine,
+            reason: "Last chunk of omitted content (may overlap if file is small)"
+          }
+        ] : []
+      ]
+    }
+  };
+}
 async function getFile(input) {
-  logger.debug("Getting file", { repo: input.repo, path: input.path });
+  logger.debug("Getting file", {
+    repo: input.repo,
+    path: input.path,
+    startLine: input.startLine,
+    endLine: input.endLine
+  });
   const repoInfo = resolveRepo(input.repo);
   if (!repoInfo) {
     return SelfCorrectionHints.UNKNOWN_REPO(
@@ -6546,12 +6699,53 @@ async function getFile(input) {
       `${repoInfo.owner}/${repoInfo.repo}`
     );
   }
+  let content = file.content;
+  let totalLines = content.split("\n").length;
+  let lineRange;
+  if (input.startLine || input.endLine) {
+    const lines = content.split("\n");
+    const start = Math.max(1, input.startLine || 1);
+    const end = Math.min(lines.length, input.endLine || lines.length);
+    if (start > end) {
+      return {
+        error: `Invalid line range: startLine (${start}) > endLine (${end})`,
+        suggestion: "Ensure startLine is less than or equal to endLine"
+      };
+    }
+    content = lines.slice(start - 1, end).join("\n");
+    lineRange = { start, end };
+    logger.debug("Extracted line range", {
+      start,
+      end,
+      extractedLines: end - start + 1
+    });
+  }
+  const truncateResult = smartTruncate(content, input.path);
+  if (truncateResult.truncated) {
+    logger.info("File content truncated", {
+      repository: `${repoInfo.owner}/${repoInfo.repo}`,
+      path: input.path,
+      language: truncateResult.truncationInfo?.language,
+      originalSize: file.size,
+      contentLength: content.length,
+      omittedLines: truncateResult.truncationInfo?.omittedLineRange
+    });
+  }
   return {
-    content: file.content,
+    content: truncateResult.content,
     path: file.path,
     repository: `${repoInfo.owner}/${repoInfo.repo}`,
     sha: file.sha,
     size: file.size,
+    totalLines,
+    ...lineRange && { lineRange },
+    truncated: truncateResult.truncated,
+    ...truncateResult.truncationInfo && {
+      truncationInfo: truncateResult.truncationInfo
+    },
+    ...truncateResult.agentGuidance && {
+      agentGuidance: truncateResult.agentGuidance
+    },
     url: `https://github.com/${repoInfo.owner}/${repoInfo.repo}/blob/${input.ref || "main"}/${file.path}`
   };
 }
@@ -6748,11 +6942,29 @@ async function getFileAtVersion(input) {
       `File not found: ${input.path} at version ${input.version} in ${repoName}`
     );
   }
+  const truncateResult = smartTruncate(result.content, input.path);
+  if (truncateResult.truncated) {
+    logger.info("File content truncated (versioned)", {
+      repository: `${resolved.owner}/${resolved.repo}`,
+      path: input.path,
+      version: input.version,
+      language: truncateResult.truncationInfo?.language,
+      contentLength: result.content.length,
+      omittedLines: truncateResult.truncationInfo?.omittedLineRange
+    });
+  }
   return {
     repository: `${resolved.owner}/${resolved.repo}`,
     path: input.path,
     version: result.version,
-    content: result.content,
+    content: truncateResult.content,
+    truncated: truncateResult.truncated,
+    ...truncateResult.truncationInfo && {
+      truncationInfo: truncateResult.truncationInfo
+    },
+    ...truncateResult.agentGuidance && {
+      agentGuidance: truncateResult.agentGuidance
+    },
     note: `This is the exact content at version ${result.version}. Use this as the source of truth for syntax and API at this version.`
   };
 }
@@ -6784,14 +6996,38 @@ async function compareSyntax(input) {
     input.oldVersion,
     newVersion
   );
+  const truncateForComparison = (content, label) => {
+    if (!content) return { content: null, truncated: false };
+    const result = smartTruncate(content, input.path);
+    if (result.truncated) {
+      logger.info("Comparison content truncated", {
+        repository: `${resolved.owner}/${resolved.repo}`,
+        path: input.path,
+        version: label,
+        language: result.truncationInfo?.language,
+        contentLength: content.length,
+        truncationInfo: result.truncationInfo
+      });
+    }
+    return result;
+  };
+  const old = truncateForComparison(
+    comparison.oldContent,
+    comparison.oldVersion
+  );
+  const newC = truncateForComparison(
+    comparison.newContent,
+    comparison.newVersion
+  );
   return {
     repository: `${resolved.owner}/${resolved.repo}`,
     path: input.path,
     oldVersion: comparison.oldVersion,
     newVersion: comparison.newVersion,
     hasDifferences: comparison.hasDifferences,
-    oldContent: comparison.oldContent,
-    newContent: comparison.newContent,
+    oldContent: old.content,
+    newContent: newC.content,
+    contentTruncated: old.truncated || newC.truncated,
     recommendation: comparison.hasDifferences ? `\u26A0\uFE0F This file has changed between ${comparison.oldVersion} and ${comparison.newVersion}. Review the differences before using code patterns from the old version.` : `\u2705 No changes in this file between versions.`
   };
 }
@@ -6989,10 +7225,25 @@ Version: ${COMPACT_VERSION.min}-${COMPACT_VERSION.max} (updated: ${COMPACT_VERSI
   return {
     repository: `${resolved.owner}/${resolved.repo}`,
     version: reference.version,
-    syntaxFiles: reference.syntaxFiles.map((f) => ({
-      path: f.path,
-      content: f.content
-    })),
+    syntaxFiles: reference.syntaxFiles.map((f) => {
+      const result = smartTruncate(f.content, f.path);
+      if (result.truncated) {
+        logger.info("Syntax file truncated", {
+          repository: `${resolved.owner}/${resolved.repo}`,
+          path: f.path,
+          version: reference.version,
+          language: result.truncationInfo?.language,
+          contentLength: f.content.length,
+          truncationInfo: result.truncationInfo
+        });
+      }
+      return {
+        path: f.path,
+        content: result.content,
+        truncated: result.truncated,
+        ...result.truncationInfo && { truncationInfo: result.truncationInfo }
+      };
+    }),
     note: `This is the authoritative syntax reference at version ${reference.version}. Use this to ensure contracts are compilable.`
   };
 }
@@ -7216,7 +7467,9 @@ var repositoryTools = [
 USAGE GUIDANCE:
 \u2022 Use midnight-list-examples first if you're unsure which file to get
 \u2022 For searching across files, use midnight-search-* tools instead
-\u2022 Use 'ref' parameter to get specific versions (branch, tag, or commit)`,
+\u2022 Use 'ref' parameter to get specific versions (branch, tag, or commit)
+\u2022 Use startLine/endLine to request specific sections of large files
+\u2022 Files >50KB are truncated (first 25KB + last 25KB preserved)`,
     inputSchema: {
       type: "object",
       properties: {
@@ -7231,6 +7484,14 @@ USAGE GUIDANCE:
         ref: {
           type: "string",
           description: "Branch, tag, or commit SHA (default: main)"
+        },
+        startLine: {
+          type: "number",
+          description: "Start line number (1-based, inclusive). Use to request specific sections."
+        },
+        endLine: {
+          type: "number",
+          description: "End line number (1-based, inclusive). Use with startLine for a range."
         }
       },
       required: ["repo", "path"]
@@ -9315,4 +9576,4 @@ export {
   startServer,
   startHttpServer
 };
-//# sourceMappingURL=chunk-L5CXYFG2.js.map
+//# sourceMappingURL=chunk-QPQOD3S6.js.map

package/dist/{chunk-WC2FPYQO.js → chunk-VQTI7YUU.js}

@@ -1594,7 +1594,7 @@ async function checkGitHubAPI() {
 }
 async function checkVectorStore() {
   try {
-    const { vectorStore: vectorStore2 } = await import("./db-2KZMPC3W.js");
+    const { vectorStore: vectorStore2 } = await import("./db-7F5YOZB7.js");
     if (vectorStore2) {
       return {
         status: "pass",
@@ -2069,7 +2069,7 @@ function serialize(data) {
 }
 
 // src/utils/version.ts
-var CURRENT_VERSION = "0.2.6";
+var CURRENT_VERSION = "0.2.8";
 
 // src/db/vectorStore.ts
 var VectorStore = class {
@@ -2278,4 +2278,4 @@ export {
   serialize,
   CURRENT_VERSION
 };
-//# sourceMappingURL=chunk-WC2FPYQO.js.map
+//# sourceMappingURL=chunk-VQTI7YUU.js.map

package/dist/db-7F5YOZB7.js

@@ -0,0 +1,7 @@
+import {
+  vectorStore
+} from "./chunk-VQTI7YUU.js";
+export {
+  vectorStore
+};
+//# sourceMappingURL=db-7F5YOZB7.js.map

package/dist/index.js

@@ -9,10 +9,10 @@ import {
   promptDefinitions,
   startHttpServer,
   startServer
-} from "./chunk-L5CXYFG2.js";
+} from "./chunk-QPQOD3S6.js";
 import {
   logger
-} from "./chunk-WC2FPYQO.js";
+} from "./chunk-VQTI7YUU.js";
 export {
   allResources,
   allTools,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "midnight-mcp",
-  "version": "0.2.6",
+  "version": "0.2.8",
   "description": "Model Context Protocol Server for Midnight Blockchain Development",
   "type": "module",
   "main": "dist/index.js",

package/dist/db-2KZMPC3W.js

@@ -1,7 +0,0 @@
-import {
-  vectorStore
-} from "./chunk-WC2FPYQO.js";
-export {
-  vectorStore
-};
-//# sourceMappingURL=db-2KZMPC3W.js.map