midnight-mcp 0.2.5 → 0.2.7

package/dist/bin.js

@@ -2,10 +2,10 @@
 import {
   startHttpServer,
   startServer
-} from "./chunk-E5HAMXS3.js";
+} from "./chunk-2YCZSMDD.js";
 import {
   setOutputFormat
-} from "./chunk-6BPO5SRQ.js";
+} from "./chunk-M3QHVBQV.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.5";
+var CURRENT_VERSION = "0.2.7";
 process.on("uncaughtException", (error) => {
   console.error("Uncaught exception:", error);
   process.exit(1);

package/dist/{chunk-E5HAMXS3.js → chunk-2YCZSMDD.js}

@@ -25,7 +25,7 @@ import {
   validateNumber,
   validateQuery,
   vectorStore
-} from "./chunk-6BPO5SRQ.js";
+} from "./chunk-M3QHVBQV.js";
 
 // src/tools/search/schemas.ts
 import { z } from "zod";
@@ -353,10 +353,10 @@ async function fetchDocs(input) {
   const { path: path2, extractSection } = input;
   let normalizedPath = path2.startsWith("/") ? path2 : `/${path2}`;
   normalizedPath = normalizedPath.replace(/\/$/, "");
-  if (/[<>"\s]/.test(normalizedPath)) {
+  if (/[<>"\s]|\.\.\/|^https?:|^\/\//.test(normalizedPath)) {
     return {
       error: "Invalid path",
-      details: ["Path contains invalid characters"],
+      details: ["Path contains invalid characters or patterns"],
       suggestion: `Use a clean path like '/develop/faq' or '/getting-started/installation'`
     };
   }
@@ -667,6 +667,8 @@ USAGE GUIDANCE:
     },
     annotations: {
       readOnlyHint: true,
+      idempotentHint: true,
+      // Same path returns same content
       openWorldHint: true,
       // Fetches from external URL
       title: "\u{1F310} Fetch Live Docs",
@@ -1113,7 +1115,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")
@@ -6523,8 +6531,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(
@@ -6544,12 +6656,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}`
   };
 }
@@ -6746,11 +6899,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.`
   };
 }
@@ -6782,14 +6953,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.`
   };
 }
@@ -6987,10 +7182,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.`
   };
 }
@@ -7214,7 +7424,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: {
@@ -7229,6 +7441,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"]
@@ -8730,13 +8950,25 @@ var INTENT_TO_TOOL = [
   {
     patterns: [
       "fetch docs",
-      "get docs",
-      "latest docs",
+      "fetch documentation",
+      "fetch the docs",
+      "fetch the latest",
+      "get the docs page",
+      "get latest docs",
       "live docs",
-      "docs page",
-      "faq",
-      "installation guide",
-      "getting started page"
+      "real-time docs",
+      "realtime docs",
+      "current docs",
+      "fresh docs",
+      "updated docs",
+      "faq page",
+      "installation page",
+      "getting started page",
+      "/develop/",
+      "/getting-started/",
+      "/compact",
+      "/blog",
+      "/learn/"
     ],
     tool: "midnight-fetch-docs",
     reason: "Fetch live documentation directly from docs.midnight.network"
@@ -9015,14 +9247,21 @@ async function suggestTool(input) {
   const intentLower = input.intent.toLowerCase();
   const matchedTools = [];
   for (const mapping of INTENT_TO_TOOL) {
-    const matchCount = mapping.patterns.filter(
+    const matchedPatterns = mapping.patterns.filter(
       (p) => intentLower.includes(p.toLowerCase())
-    ).length;
+    );
+    const matchCount = matchedPatterns.length;
     if (matchCount > 0) {
+      const patternLengthScore = matchedPatterns.reduce(
+        (sum, p) => sum + p.length,
+        0
+      );
+      const matchScore = matchCount * 10 + patternLengthScore;
       matchedTools.push({
         tool: mapping.tool,
         reason: mapping.reason,
-        confidence: matchCount >= 2 ? "high" : "medium"
+        confidence: matchCount >= 2 ? "high" : "medium",
+        matchScore
       });
     }
   }
@@ -9041,9 +9280,11 @@ async function suggestTool(input) {
     }
   }
   const confidenceOrder = { high: 0, medium: 1, low: 2 };
-  matchedTools.sort(
-    (a, b) => confidenceOrder[a.confidence] - confidenceOrder[b.confidence]
-  );
+  matchedTools.sort((a, b) => {
+    const confDiff = confidenceOrder[a.confidence] - confidenceOrder[b.confidence];
+    if (confDiff !== 0) return confDiff;
+    return b.matchScore - a.matchScore;
+  });
   if (matchedTools.length === 0 && matchedCategories.length === 0) {
     return {
       intent: input.intent,
@@ -9292,4 +9533,4 @@ export {
   startServer,
   startHttpServer
 };
-//# sourceMappingURL=chunk-E5HAMXS3.js.map
+//# sourceMappingURL=chunk-2YCZSMDD.js.map

package/dist/{chunk-6BPO5SRQ.js → chunk-M3QHVBQV.js}

@@ -1594,7 +1594,7 @@ async function checkGitHubAPI() {
 }
 async function checkVectorStore() {
   try {
-    const { vectorStore: vectorStore2 } = await import("./db-F27LE73N.js");
+    const { vectorStore: vectorStore2 } = await import("./db-OENJQB5W.js");
     if (vectorStore2) {
       return {
         status: "pass",
@@ -2069,7 +2069,7 @@ function serialize(data) {
 }
 
 // src/utils/version.ts
-var CURRENT_VERSION = "0.2.5";
+var CURRENT_VERSION = "0.2.7";
 
 // src/db/vectorStore.ts
 var VectorStore = class {
@@ -2278,4 +2278,4 @@ export {
   serialize,
   CURRENT_VERSION
 };
-//# sourceMappingURL=chunk-6BPO5SRQ.js.map
+//# sourceMappingURL=chunk-M3QHVBQV.js.map

package/dist/db-OENJQB5W.js

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

package/dist/index.js

@@ -9,10 +9,10 @@ import {
   promptDefinitions,
   startHttpServer,
   startServer
-} from "./chunk-E5HAMXS3.js";
+} from "./chunk-2YCZSMDD.js";
 import {
   logger
-} from "./chunk-6BPO5SRQ.js";
+} from "./chunk-M3QHVBQV.js";
 export {
   allResources,
   allTools,

package/package.json

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

package/dist/db-F27LE73N.js

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