midnight-mcp 0.1.8 → 0.1.10

package/dist/utils/errors.d.ts

@@ -25,6 +25,72 @@ export declare const ErrorCodes: {
     readonly PARSE_ERROR: "PARSE_ERROR";
     readonly CHROMADB_UNAVAILABLE: "CHROMADB_UNAVAILABLE";
     readonly OPENAI_UNAVAILABLE: "OPENAI_UNAVAILABLE";
+    readonly MISSING_PARAM: "MISSING_PARAMETER";
+    readonly INVALID_VERSION: "INVALID_VERSION";
+    readonly SAMPLING_UNAVAILABLE: "SAMPLING_UNAVAILABLE";
+};
+/**
+ * LLM-friendly error hints that help the model self-correct
+ * These are designed to give the AI enough context to retry with corrected input
+ */
+export declare const SelfCorrectionHints: {
+    UNKNOWN_REPO: (repo: string, validRepos: string[]) => {
+        error: string;
+        code: "UNKNOWN_REPOSITORY";
+        suggestion: string;
+        correction: {
+            invalidValue: string;
+            validValues: string[];
+            parameterName: string;
+        };
+    };
+    INVALID_VERSION: (version: string, example: string) => {
+        error: string;
+        code: "INVALID_VERSION";
+        suggestion: string;
+        correction: {
+            invalidValue: string;
+            expectedFormat: string;
+            example: string;
+        };
+    };
+    MISSING_REQUIRED_PARAM: (paramName: string, toolName: string) => {
+        error: string;
+        code: "MISSING_PARAMETER";
+        suggestion: string;
+        correction: {
+            missingParameter: string;
+            tool: string;
+        };
+    };
+    FILE_NOT_FOUND: (path: string, repo: string, similarPaths?: string[]) => {
+        error: string;
+        code: "RESOURCE_NOT_FOUND";
+        suggestion: string;
+        correction: {
+            suggestions?: string[] | undefined;
+            invalidPath: string;
+        };
+    };
+    SAMPLING_NOT_AVAILABLE: (toolName: string) => {
+        error: string;
+        code: "SAMPLING_UNAVAILABLE";
+        suggestion: string;
+        alternatives: {
+            "midnight-generate-contract": string;
+            "midnight-review-contract": string;
+            "midnight-document-contract": string;
+        };
+    };
+    RATE_LIMIT: (retryAfter?: number) => {
+        error: string;
+        code: "RATE_LIMIT_EXCEEDED";
+        suggestion: string;
+        correction: {
+            retryAfterSeconds?: number | undefined;
+            action: string;
+        };
+    };
 };
 /**
  * Create user-friendly error from various error types

package/dist/utils/errors.js

@@ -33,6 +33,76 @@ export const ErrorCodes = {
     PARSE_ERROR: "PARSE_ERROR",
     CHROMADB_UNAVAILABLE: "CHROMADB_UNAVAILABLE",
     OPENAI_UNAVAILABLE: "OPENAI_UNAVAILABLE",
+    MISSING_PARAM: "MISSING_PARAMETER",
+    INVALID_VERSION: "INVALID_VERSION",
+    SAMPLING_UNAVAILABLE: "SAMPLING_UNAVAILABLE",
+};
+/**
+ * LLM-friendly error hints that help the model self-correct
+ * These are designed to give the AI enough context to retry with corrected input
+ */
+export const SelfCorrectionHints = {
+    UNKNOWN_REPO: (repo, validRepos) => ({
+        error: `Unknown repository: '${repo}'`,
+        code: ErrorCodes.UNKNOWN_REPO,
+        suggestion: `Try one of these instead: ${validRepos.slice(0, 8).join(", ")}`,
+        correction: {
+            invalidValue: repo,
+            validValues: validRepos,
+            parameterName: "repo",
+        },
+    }),
+    INVALID_VERSION: (version, example) => ({
+        error: `Invalid version format: '${version}'`,
+        code: ErrorCodes.INVALID_VERSION,
+        suggestion: `Version should be like '${example}'. Check available versions with midnight-get-version-info first.`,
+        correction: {
+            invalidValue: version,
+            expectedFormat: "v1.0.0 or 0.14.0",
+            example,
+        },
+    }),
+    MISSING_REQUIRED_PARAM: (paramName, toolName) => ({
+        error: `Missing required parameter: '${paramName}'`,
+        code: ErrorCodes.MISSING_PARAM,
+        suggestion: `The '${paramName}' parameter is required for ${toolName}. Please provide it.`,
+        correction: {
+            missingParameter: paramName,
+            tool: toolName,
+        },
+    }),
+    FILE_NOT_FOUND: (path, repo, similarPaths) => ({
+        error: `File not found: '${path}' in ${repo}`,
+        code: ErrorCodes.NOT_FOUND,
+        suggestion: similarPaths?.length
+            ? `Did you mean: ${similarPaths.join(", ")}?`
+            : `Check the file path. Use midnight-get-file with a different path or list directory contents first.`,
+        correction: {
+            invalidPath: path,
+            ...(similarPaths && { suggestions: similarPaths }),
+        },
+    }),
+    SAMPLING_NOT_AVAILABLE: (toolName) => ({
+        error: `Sampling capability not available`,
+        code: ErrorCodes.SAMPLING_UNAVAILABLE,
+        suggestion: `${toolName} requires a client that supports sampling (e.g., Claude Desktop). Use a non-AI alternative or switch clients.`,
+        alternatives: {
+            "midnight-generate-contract": "Use midnight-search-compact to find similar contracts as templates",
+            "midnight-review-contract": "Use midnight-analyze-contract for static analysis",
+            "midnight-document-contract": "Manual documentation or inline comments",
+        },
+    }),
+    RATE_LIMIT: (retryAfter) => ({
+        error: "GitHub API rate limit exceeded",
+        code: ErrorCodes.RATE_LIMIT,
+        suggestion: retryAfter
+            ? `Wait ${retryAfter} seconds before retrying. Or add GITHUB_TOKEN for higher limits.`
+            : "Add GITHUB_TOKEN to increase from 60 to 5000 requests/hour.",
+        correction: {
+            action: "wait_and_retry",
+            ...(retryAfter && { retryAfterSeconds: retryAfter }),
+        },
+    }),
 };
 /**
  * Create user-friendly error from various error types

package/dist/utils/index.d.ts

@@ -2,7 +2,7 @@ export { config, isHostedMode, isLocalMode } from "./config.js";
 export type { Config, RepositoryConfig } from "./config.js";
 export { DEFAULT_REPOSITORIES } from "./config.js";
 export { logger } from "./logger.js";
-export { MCPError, ErrorCodes, createUserError, formatErrorResponse, withErrorHandling, } from "./errors.js";
+export { MCPError, ErrorCodes, createUserError, formatErrorResponse, withErrorHandling, SelfCorrectionHints, } from "./errors.js";
 export { validateQuery, validateRepository, validatePath, validateRef, validateNumber, validateToolArgs, sanitizeString, } from "./validation.js";
 export type { ValidationResult } from "./validation.js";
 export { getHealthStatus, getQuickHealthStatus } from "./health.js";

package/dist/utils/index.js

@@ -1,7 +1,7 @@
 export { config, isHostedMode, isLocalMode } from "./config.js";
 export { DEFAULT_REPOSITORIES } from "./config.js";
 export { logger } from "./logger.js";
-export { MCPError, ErrorCodes, createUserError, formatErrorResponse, withErrorHandling, } from "./errors.js";
+export { MCPError, ErrorCodes, createUserError, formatErrorResponse, withErrorHandling, SelfCorrectionHints, } from "./errors.js";
 // Validation utilities
 export { validateQuery, validateRepository, validatePath, validateRef, validateNumber, validateToolArgs, sanitizeString, } from "./validation.js";
 // Health check utilities

package/package.json

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