midnight-mcp 0.1.40 → 0.2.1

package/dist/utils/config.js

@@ -1,294 +0,0 @@
-import { z } from "zod";
-import dotenv from "dotenv";
-dotenv.config();
-const ConfigSchema = z.object({
-    // Mode: 'hosted' (default) or 'local'
-    mode: z.enum(["hosted", "local"]).default("hosted"),
-    // Hosted API URL (used when mode is 'hosted')
-    hostedApiUrl: z
-        .string()
-        .default("https://midnight-mcp-api.midnightmcp.workers.dev"),
-    // GitHub
-    githubToken: z.string().optional(),
-    // Vector Database (only needed for local mode)
-    chromaUrl: z.string().default("http://localhost:8000"),
-    // Embeddings (only needed for local mode)
-    openaiApiKey: z.string().optional(),
-    embeddingModel: z.string().default("text-embedding-3-small"),
-    // Server
-    logLevel: z.enum(["debug", "info", "warn", "error"]).default("info"),
-    syncInterval: z.number().default(900000), // 15 minutes
-    port: z.number().default(3000),
-    // Data directories
-    dataDir: z.string().default("./data"),
-    cacheDir: z.string().default("./cache"),
-});
-function loadConfig() {
-    // Determine mode: local if MIDNIGHT_LOCAL=true or if OPENAI_API_KEY is set
-    const isLocalMode = process.env.MIDNIGHT_LOCAL === "true" ||
-        (process.env.OPENAI_API_KEY && process.env.CHROMA_URL);
-    const rawConfig = {
-        mode: isLocalMode ? "local" : "hosted",
-        hostedApiUrl: process.env.MIDNIGHT_API_URL,
-        githubToken: process.env.GITHUB_TOKEN,
-        chromaUrl: process.env.CHROMA_URL,
-        openaiApiKey: process.env.OPENAI_API_KEY,
-        embeddingModel: process.env.EMBEDDING_MODEL,
-        logLevel: process.env.LOG_LEVEL,
-        syncInterval: process.env.SYNC_INTERVAL
-            ? parseInt(process.env.SYNC_INTERVAL)
-            : undefined,
-        port: process.env.PORT ? parseInt(process.env.PORT) : undefined,
-        dataDir: process.env.DATA_DIR,
-        cacheDir: process.env.CACHE_DIR,
-    };
-    // Remove undefined values
-    const cleanConfig = Object.fromEntries(Object.entries(rawConfig).filter(([_, v]) => v !== undefined));
-    return ConfigSchema.parse(cleanConfig);
-}
-export const config = loadConfig();
-/**
- * Check if running in hosted mode (default)
- */
-export function isHostedMode() {
-    return config.mode === "hosted";
-}
-/**
- * Check if running in local mode
- */
-export function isLocalMode() {
-    return config.mode === "local";
-}
-export const DEFAULT_REPOSITORIES = [
-    // Core Language & SDK
-    {
-        owner: "midnightntwrk",
-        repo: "compact",
-        branch: "main",
-        patterns: ["**/*.compact", "**/*.ts", "**/*.md"],
-        exclude: ["node_modules/**", "dist/**"],
-    },
-    {
-        owner: "midnightntwrk",
-        repo: "midnight-js",
-        branch: "main",
-        patterns: ["**/*.ts", "**/*.md"],
-        exclude: ["node_modules/**", "dist/**"],
-    },
-    // Documentation
-    {
-        owner: "midnightntwrk",
-        repo: "midnight-docs",
-        branch: "main",
-        patterns: ["**/*.md", "**/*.mdx"],
-        exclude: ["node_modules/**"],
-    },
-    // Example DApps
-    {
-        owner: "midnightntwrk",
-        repo: "example-counter",
-        branch: "main",
-        patterns: ["**/*.compact", "**/*.ts", "**/*.md"],
-        exclude: ["node_modules/**", "dist/**"],
-    },
-    {
-        owner: "midnightntwrk",
-        repo: "example-bboard",
-        branch: "main",
-        patterns: ["**/*.compact", "**/*.ts", "**/*.tsx", "**/*.md"],
-        exclude: ["node_modules/**", "dist/**"],
-    },
-    {
-        owner: "midnightntwrk",
-        repo: "example-dex",
-        branch: "main",
-        patterns: ["**/*.compact", "**/*.ts", "**/*.tsx", "**/*.md"],
-        exclude: ["node_modules/**", "dist/**"],
-    },
-    // Developer Tools
-    {
-        owner: "midnightntwrk",
-        repo: "create-mn-app",
-        branch: "main",
-        patterns: ["**/*.ts", "**/*.md", "**/*.json"],
-        exclude: ["node_modules/**", "dist/**"],
-    },
-    {
-        owner: "midnightntwrk",
-        repo: "midnight-wallet",
-        branch: "main",
-        patterns: ["**/*.ts", "**/*.tsx", "**/*.md"],
-        exclude: ["node_modules/**", "dist/**"],
-    },
-    // Infrastructure
-    {
-        owner: "midnightntwrk",
-        repo: "midnight-indexer",
-        branch: "main",
-        patterns: ["**/*.ts", "**/*.md", "**/*.rs"],
-        exclude: ["node_modules/**", "dist/**", "target/**"],
-    },
-    {
-        owner: "midnightntwrk",
-        repo: "midnight-node-docker",
-        branch: "main",
-        patterns: ["**/*.md", "**/Dockerfile", "**/*.yml", "**/*.yaml"],
-        exclude: [],
-    },
-    // APIs & Connectors
-    {
-        owner: "midnightntwrk",
-        repo: "midnight-dapp-connector-api",
-        branch: "main",
-        patterns: ["**/*.ts", "**/*.md"],
-        exclude: ["node_modules/**", "dist/**"],
-    },
-    // Tooling
-    {
-        owner: "midnightntwrk",
-        repo: "compact-tree-sitter",
-        branch: "main",
-        patterns: ["**/*.js", "**/*.md", "**/*.scm"],
-        exclude: ["node_modules/**"],
-    },
-    {
-        owner: "midnightntwrk",
-        repo: "setup-compact-action",
-        branch: "main",
-        patterns: ["**/*.ts", "**/*.js", "**/*.md", "**/*.yml", "**/*.yaml"],
-        exclude: ["node_modules/**", "dist/**"],
-    },
-    // Community
-    {
-        owner: "midnightntwrk",
-        repo: "midnight-awesome-dapps",
-        branch: "main",
-        patterns: ["**/*.md"],
-        exclude: [],
-    },
-    {
-        owner: "midnightntwrk",
-        repo: "contributor-hub",
-        branch: "main",
-        patterns: ["**/*.md"],
-        exclude: [],
-    },
-    // Partner Libraries (OpenZeppelin)
-    {
-        owner: "OpenZeppelin",
-        repo: "compact-contracts",
-        branch: "main",
-        patterns: ["**/*.compact", "**/*.ts", "**/*.md"],
-        exclude: ["node_modules/**", "dist/**"],
-    },
-    {
-        owner: "OpenZeppelin",
-        repo: "midnight-apps",
-        branch: "main",
-        patterns: ["**/*.compact", "**/*.ts", "**/*.md"],
-        exclude: ["node_modules/**", "dist/**"],
-    },
-    // Official Partners (from awesome-dapps)
-    {
-        owner: "bricktowers",
-        repo: "midnight-seabattle",
-        branch: "main",
-        patterns: ["**/*.compact", "**/*.ts", "**/*.md"],
-        exclude: ["node_modules/**", "dist/**"],
-    },
-    {
-        owner: "bricktowers",
-        repo: "midnight-identity",
-        branch: "main",
-        patterns: ["**/*.compact", "**/*.ts", "**/*.md"],
-        exclude: ["node_modules/**", "dist/**"],
-    },
-    {
-        owner: "bricktowers",
-        repo: "midnight-rwa",
-        branch: "main",
-        patterns: ["**/*.compact", "**/*.ts", "**/*.md"],
-        exclude: ["node_modules/**", "dist/**"],
-    },
-    {
-        owner: "MeshJS",
-        repo: "midnight-starter-template",
-        branch: "main",
-        patterns: ["**/*.compact", "**/*.ts", "**/*.md"],
-        exclude: ["node_modules/**", "dist/**"],
-    },
-    {
-        owner: "midnames",
-        repo: "core",
-        branch: "main",
-        patterns: ["**/*.compact", "**/*.ts", "**/*.md"],
-        exclude: ["node_modules/**", "dist/**"],
-    },
-    // Sea Battle Hackathon Winners (Feb 2025)
-    {
-        owner: "ErickRomeroDev",
-        repo: "naval-battle-game_v2",
-        branch: "main",
-        patterns: ["**/*.compact", "**/*.ts", "**/*.tsx", "**/*.md"],
-        exclude: ["node_modules/**", "dist/**"],
-    },
-    {
-        owner: "eddex",
-        repo: "midnight-sea-battle-hackathon",
-        branch: "main",
-        patterns: ["**/*.compact", "**/*.ts", "**/*.md"],
-        exclude: ["node_modules/**", "dist/**"],
-    },
-    // Mini DApp Hackathon Winners (Sep 2025)
-    {
-        owner: "statera-protocol",
-        repo: "statera-protocol-midnight",
-        branch: "main",
-        patterns: ["**/*.compact", "**/*.ts", "**/*.md"],
-        exclude: ["node_modules/**", "dist/**"],
-    },
-    {
-        owner: "nel349",
-        repo: "midnight-bank",
-        branch: "main",
-        patterns: ["**/*.compact", "**/*.ts", "**/*.md"],
-        exclude: ["node_modules/**", "dist/**"],
-    },
-    {
-        owner: "Imdavyking",
-        repo: "zkbadge",
-        branch: "main",
-        patterns: ["**/*.compact", "**/*.ts", "**/*.md"],
-        exclude: ["node_modules/**", "dist/**"],
-    },
-    // Core Partner - PaimaStudios (Gaming Infrastructure)
-    {
-        owner: "PaimaStudios",
-        repo: "midnight-game-2",
-        branch: "main",
-        patterns: ["**/*.compact", "**/*.ts", "**/*.tsx", "**/*.js", "**/*.md"],
-        exclude: ["node_modules/**", "dist/**", "phaser/node_modules/**"],
-    },
-    {
-        owner: "PaimaStudios",
-        repo: "midnight-wasm-prover",
-        branch: "main",
-        patterns: ["**/*.rs", "**/*.ts", "**/*.md"],
-        exclude: ["target/**", "node_modules/**", "pkg/**"],
-    },
-    {
-        owner: "PaimaStudios",
-        repo: "midnight-batcher",
-        branch: "main",
-        patterns: ["**/*.rs", "**/*.ts", "**/*.md"],
-        exclude: ["target/**", "node_modules/**"],
-    },
-    {
-        owner: "PaimaStudios",
-        repo: "midnight-impact-rps-example",
-        branch: "main",
-        patterns: ["**/*.rs", "**/*.ts", "**/*.md"],
-        exclude: ["target/**", "node_modules/**", "www/pkg/**"],
-    },
-];
-//# sourceMappingURL=config.js.map

package/dist/utils/errors.d.ts

@@ -1,111 +0,0 @@
-/**
- * User-friendly error messages and error handling utilities
- */
-export declare class MCPError extends Error {
-    readonly code: string;
-    readonly suggestion?: string;
-    readonly details?: Record<string, unknown>;
-    constructor(message: string, code: string, suggestion?: string, details?: Record<string, unknown>);
-    toJSON(): {
-        details?: Record<string, unknown> | undefined;
-        error: string;
-        code: string;
-        suggestion: string | undefined;
-    };
-}
-/**
- * Common error codes
- */
-export declare const ErrorCodes: {
-    readonly RATE_LIMIT: "RATE_LIMIT_EXCEEDED";
-    readonly NOT_FOUND: "RESOURCE_NOT_FOUND";
-    readonly NETWORK: "NETWORK_ERROR";
-    readonly INVALID_INPUT: "INVALID_INPUT";
-    readonly UNKNOWN_REPO: "UNKNOWN_REPOSITORY";
-    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
- */
-export declare function createUserError(error: unknown, context?: string): MCPError;
-/**
- * Format error for MCP response
- */
-export declare function formatErrorResponse(error: unknown, context?: string): {
-    error: string;
-    code: string;
-    suggestion?: string;
-};
-/**
- * Wrap a function with error handling
- */
-export declare function withErrorHandling<T extends (...args: unknown[]) => Promise<unknown>>(fn: T, context: string): T;
-//# sourceMappingURL=errors.d.ts.map

package/dist/utils/errors.js

@@ -1,165 +0,0 @@
-/**
- * User-friendly error messages and error handling utilities
- */
-export class MCPError extends Error {
-    code;
-    suggestion;
-    details;
-    constructor(message, code, suggestion, details) {
-        super(message);
-        this.name = "MCPError";
-        this.code = code;
-        this.suggestion = suggestion;
-        this.details = details;
-    }
-    toJSON() {
-        return {
-            error: this.message,
-            code: this.code,
-            suggestion: this.suggestion,
-            ...(this.details && { details: this.details }),
-        };
-    }
-}
-/**
- * Common error codes
- */
-export const ErrorCodes = {
-    RATE_LIMIT: "RATE_LIMIT_EXCEEDED",
-    NOT_FOUND: "RESOURCE_NOT_FOUND",
-    NETWORK: "NETWORK_ERROR",
-    INVALID_INPUT: "INVALID_INPUT",
-    UNKNOWN_REPO: "UNKNOWN_REPOSITORY",
-    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
- */
-export function createUserError(error, context) {
-    const message = error instanceof Error ? error.message : String(error);
-    const ctx = context ? ` while ${context}` : "";
-    // Rate limit errors
-    if (message.includes("rate limit") ||
-        message.includes("403") ||
-        message.includes("API rate limit")) {
-        return new MCPError(`GitHub API rate limit exceeded${ctx}`, ErrorCodes.RATE_LIMIT, "Add GITHUB_TOKEN to your config to increase limits from 60 to 5000 requests/hour. " +
-            "Get a token at https://github.com/settings/tokens");
-    }
-    // Not found errors
-    if (message.includes("404") || message.includes("Not Found")) {
-        return new MCPError(`Resource not found${ctx}`, ErrorCodes.NOT_FOUND, "Check that the repository, file, or version exists and is publicly accessible.");
-    }
-    // Network errors
-    if (message.includes("network") ||
-        message.includes("ECONNREFUSED") ||
-        message.includes("ETIMEDOUT") ||
-        message.includes("timeout")) {
-        return new MCPError(`Network error${ctx}`, ErrorCodes.NETWORK, "Check your internet connection and try again. If the problem persists, " +
-            "the service may be temporarily unavailable.");
-    }
-    // ChromaDB errors
-    if (message.includes("chroma") || message.includes("8000")) {
-        return new MCPError(`ChromaDB is not available${ctx}`, ErrorCodes.CHROMADB_UNAVAILABLE, "ChromaDB is optional. Without it, search uses keyword matching instead of semantic search. " +
-            "To enable semantic search, run: docker run -d -p 8000:8000 chromadb/chroma");
-    }
-    // OpenAI errors
-    if (message.includes("openai") || message.includes("embedding")) {
-        return new MCPError(`OpenAI API error${ctx}`, ErrorCodes.OPENAI_UNAVAILABLE, "OpenAI is optional. Without it, search uses keyword matching. " +
-            "To enable semantic search, add OPENAI_API_KEY to your config.");
-    }
-    // Default error - don't leak internal details
-    return new MCPError(`An error occurred${ctx}`, "UNKNOWN_ERROR", "If this problem persists, please report it at https://github.com/Olanetsoft/midnight-mcp/issues");
-}
-/**
- * Format error for MCP response
- */
-export function formatErrorResponse(error, context) {
-    const mcpError = error instanceof MCPError ? error : createUserError(error, context);
-    return mcpError.toJSON();
-}
-/**
- * Wrap a function with error handling
- */
-export function withErrorHandling(fn, context) {
-    return (async (...args) => {
-        try {
-            return await fn(...args);
-        }
-        catch (error) {
-            throw createUserError(error, context);
-        }
-    });
-}
-//# sourceMappingURL=errors.js.map

package/dist/utils/health.d.ts

@@ -1,29 +0,0 @@
-/**
- * Health check utilities for MCP server monitoring
- */
-export interface HealthStatus {
-    status: "healthy" | "degraded" | "unhealthy";
-    timestamp: string;
-    version: string;
-    uptime: number;
-    checks: {
-        name: string;
-        status: "pass" | "warn" | "fail";
-        message?: string;
-        latency?: number;
-    }[];
-}
-/**
- * Perform a full health check
- */
-export declare function getHealthStatus(): Promise<HealthStatus>;
-/**
- * Get a quick health check (no external calls)
- */
-export declare function getQuickHealthStatus(): Omit<HealthStatus, "checks"> & {
-    checks: {
-        name: string;
-        status: "pass";
-    }[];
-};
-//# sourceMappingURL=health.d.ts.map