midnight-mcp 0.2.7 → 0.2.9

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-2YCZSMDD.js";
+} from "./chunk-5PGBYGCG.js";
 import {
   setOutputFormat
-} from "./chunk-M3QHVBQV.js";
+} from "./chunk-WZVWUFLH.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.7";
+var CURRENT_VERSION = "0.2.9";
 process.on("uncaughtException", (error) => {
   console.error("Uncaught exception:", error);
   process.exit(1);

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

@@ -25,7 +25,7 @@ import {
   validateNumber,
   validateQuery,
   vectorStore
-} from "./chunk-M3QHVBQV.js";
+} from "./chunk-WZVWUFLH.js";
 
 // src/tools/search/schemas.ts
 import { z } from "zod";
@@ -102,7 +102,49 @@ async function tryHostedSearch(searchType, hostedSearchFn, cacheKey, warnings) {
       ...response,
       ...warnings.length > 0 && { warnings }
     };
-    searchCache.set(cacheKey, finalResponse);
+    searchCache.set(cacheKey, {
+      results: finalResponse.results.map((item) => {
+        const result = item;
+        let startLine;
+        let endLine;
+        if (result.source.lines) {
+          const lineParts = result.source.lines.split("-");
+          if (lineParts.length === 2) {
+            const parsedStart = parseInt(lineParts[0], 10);
+            const parsedEnd = parseInt(lineParts[1], 10);
+            if (!Number.isNaN(parsedStart)) {
+              startLine = parsedStart;
+            }
+            if (!Number.isNaN(parsedEnd)) {
+              endLine = parsedEnd;
+            }
+          } else if (lineParts.length === 1) {
+            const parsed = parseInt(lineParts[0], 10);
+            if (!Number.isNaN(parsed)) {
+              startLine = endLine = parsed;
+            }
+          }
+        }
+        return {
+          code: result.code,
+          content: result.content,
+          relevanceScore: result.relevanceScore,
+          source: {
+            repository: result.source.repository,
+            filePath: result.source.filePath,
+            startLine,
+            endLine,
+            lines: result.source.lines,
+            section: result.source.section
+          },
+          codeType: result.codeType,
+          name: result.name,
+          isExported: result.isExported
+        };
+      }),
+      totalResults: finalResponse.totalResults ?? finalResponse.results.length,
+      warnings: warnings.length > 0 ? warnings : void 0
+    });
     return {
       result: finalResponse,
       cached: true
@@ -122,7 +164,11 @@ function finalizeResponse(response, cacheKey, warnings) {
     ...response,
     ...warnings.length > 0 && { warnings }
   };
-  searchCache.set(cacheKey, finalResponse);
+  searchCache.set(cacheKey, {
+    results: finalResponse.results,
+    totalResults: finalResponse.totalResults ?? finalResponse.results.length,
+    warnings: warnings.length > 0 ? warnings : void 0
+  });
   return finalResponse;
 }
 async function searchCompact(input) {
@@ -794,8 +840,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 = [];
@@ -4536,15 +4592,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"
     );
@@ -4567,11 +4630,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()) {
@@ -5170,6 +5247,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: [
             {
@@ -5177,8 +5265,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
               })
             }
           ]
@@ -5809,6 +5898,9 @@ CORRECT: pure circuit helper(...): Type { }`
 import { readFile } from "fs/promises";
 import { basename, isAbsolute, resolve } from "path";
 import { platform } from "process";
+function escapeRegex(str) {
+  return str.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+}
 function validateFilePath(filePath) {
   if (!isAbsolute(filePath)) {
     return {
@@ -6268,16 +6360,20 @@ async function extractContractStructure(input) {
   if (sealedFields.length > 0) {
     for (const circuit of circuits) {
       if (circuit.isExport) {
+        const escapedCircuitName = escapeRegex(circuit.name);
         const circuitBodyMatch = code.match(
           new RegExp(
-            `(?:export\\s+)?circuit\\s+${circuit.name}\\s*\\([^)]*\\)\\s*:[^{]*\\{([\\s\\S]*?)\\n\\}`,
+            `(?:export\\s+)?circuit\\s+${escapedCircuitName}\\s*\\([^)]*\\)\\s*:[^{]*\\{([\\s\\S]*?)\\n\\}`,
             "m"
           )
         );
         if (circuitBodyMatch) {
           const body = circuitBodyMatch[1];
           for (const field of sealedFields) {
-            if (new RegExp(`\\b${field.name}\\s*=`).test(body) || new RegExp(`\\b${field.name}\\s*\\.\\s*\\w+\\s*\\(`).test(body)) {
+            const escapedFieldName = escapeRegex(field.name);
+            if (new RegExp(`\\b${escapedFieldName}\\s*=`).test(body) || new RegExp(`\\b${escapedFieldName}\\s*\\.\\s*\\w+\\s*\\(`).test(
+              body
+            )) {
               potentialIssues.push({
                 type: "sealed_export_conflict",
                 line: circuit.line,
@@ -6426,8 +6522,9 @@ async function extractContractStructure(input) {
       constructorParams.push(paramMatch[1]);
     }
     for (const param of constructorParams) {
+      const escapedParam = escapeRegex(param);
       const assignmentPattern = new RegExp(
-        `(\\w+)\\s*=\\s*(?!disclose\\s*\\()${param}\\b`,
+        `(\\w+)\\s*=\\s*(?!disclose\\s*\\()${escapedParam}\\b`,
         "g"
       );
       let assignMatch;
@@ -9533,4 +9630,4 @@ export {
   startServer,
   startHttpServer
 };
-//# sourceMappingURL=chunk-2YCZSMDD.js.map
+//# sourceMappingURL=chunk-5PGBYGCG.js.map

package/dist/{chunk-M3QHVBQV.js → chunk-WZVWUFLH.js}

@@ -851,7 +851,11 @@ var GitHubClient = class {
     }
   }
   /**
-   * Filter files by patterns
+   * Filter files by patterns (glob matching)
+   *
+   * SECURITY NOTE: Patterns come from trusted REPOSITORIES config, not user input.
+   * The glob-to-regex conversion only handles **, *, and . characters.
+   * This is safe because malicious patterns could only come from internal config.
    */
   filterFilesByPatterns(files, patterns, exclude) {
     const matchPattern = (file, pattern) => {
@@ -1016,6 +1020,20 @@ var GitHubClient = class {
 var githubClient = new GitHubClient();
 
 // src/pipeline/parser.ts
+var LANGUAGES = {
+  COMPACT: "compact",
+  TYPESCRIPT: "typescript",
+  MARKDOWN: "markdown"
+};
+var EXTENSION_LANGUAGE_MAP = {
+  compact: LANGUAGES.COMPACT,
+  ts: LANGUAGES.TYPESCRIPT,
+  tsx: LANGUAGES.TYPESCRIPT,
+  js: LANGUAGES.TYPESCRIPT,
+  jsx: LANGUAGES.TYPESCRIPT,
+  md: LANGUAGES.MARKDOWN,
+  mdx: LANGUAGES.MARKDOWN
+};
 function parseCompactFile(path, content) {
   const lines = content.split("\n");
   const codeUnits = [];
@@ -1161,7 +1179,7 @@ function parseCompactFile(path, content) {
   }
   return {
     path,
-    language: "compact",
+    language: LANGUAGES.COMPACT,
     content,
     codeUnits,
     imports,
@@ -1594,7 +1612,7 @@ async function checkGitHubAPI() {
 }
 async function checkVectorStore() {
   try {
-    const { vectorStore: vectorStore2 } = await import("./db-OENJQB5W.js");
+    const { vectorStore: vectorStore2 } = await import("./db-2VUY2I5E.js");
     if (vectorStore2) {
       return {
         status: "pass",
@@ -2069,7 +2087,7 @@ function serialize(data) {
 }
 
 // src/utils/version.ts
-var CURRENT_VERSION = "0.2.7";
+var CURRENT_VERSION = "0.2.9";
 
 // src/db/vectorStore.ts
 var VectorStore = class {
@@ -2278,4 +2296,4 @@ export {
   serialize,
   CURRENT_VERSION
 };
-//# sourceMappingURL=chunk-M3QHVBQV.js.map
+//# sourceMappingURL=chunk-WZVWUFLH.js.map

package/dist/db-2VUY2I5E.js

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

package/dist/index.d.ts

@@ -85,6 +85,13 @@ interface PropertySchema {
     properties?: Record<string, PropertySchema>;
     enum?: string[];
 }
+/**
+ * Extended tool definition with handler
+ *
+ * Note: Handler uses `unknown` for input to allow flexibility in tool implementations.
+ * Each tool module defines its own specific input/output types via Zod schemas.
+ * The MCP server validates inputs against the inputSchema before calling handlers.
+ */
 interface ExtendedToolDefinition {
     name: string;
     description: string;
@@ -95,7 +102,15 @@ interface ExtendedToolDefinition {
     };
     outputSchema?: OutputSchema;
     annotations?: ToolAnnotations;
-    handler: (input: any) => Promise<any>;
+    /**
+     * Handler function that processes tool inputs
+     * Input is validated against inputSchema before this is called
+     * Output should match outputSchema if defined
+     *
+     * Using `unknown` allows specific handler types to be assigned.
+     * Type safety is enforced by Zod schema validation at runtime.
+     */
+    handler: (input: any) => Promise<unknown>;
 }
 
 /**

package/dist/index.js

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

package/package.json

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

package/dist/db-OENJQB5W.js

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