midnight-mcp 0.1.40 → 0.2.1

package/dist/tools/health.js

@@ -1,362 +0,0 @@
-/**
- * Health check and diagnostic tools for MCP server
- */
-import { z } from "zod";
-import * as os from "os";
-import * as path from "path";
-import { getHealthStatus, getQuickHealthStatus, getRateLimitStatus, formatRateLimitStatus, } from "../utils/index.js";
-import { searchCache, fileCache, metadataCache } from "../utils/cache.js";
-// Current version - should match package.json
-const CURRENT_VERSION = "0.1.30";
-// Schema definitions
-export const HealthCheckInputSchema = z.object({
-    detailed: z
-        .boolean()
-        .optional()
-        .default(false)
-        .describe("Include detailed checks (slower but more comprehensive)"),
-});
-export const GetStatusInputSchema = z.object({});
-export const CheckVersionInputSchema = z.object({});
-/**
- * Perform health check on the MCP server
- */
-export async function healthCheck(input) {
-    if (input.detailed) {
-        const status = await getHealthStatus();
-        return {
-            ...status,
-            rateLimit: formatRateLimitStatus(),
-            cacheStats: {
-                search: searchCache.getStats(),
-                file: fileCache.getStats(),
-                metadata: metadataCache.getStats(),
-            },
-        };
-    }
-    return {
-        ...getQuickHealthStatus(),
-        rateLimit: formatRateLimitStatus(),
-    };
-}
-/**
- * Get current server status and statistics
- */
-export async function getStatus(_input) {
-    const rateLimitStatus = getRateLimitStatus();
-    return {
-        server: "midnight-mcp",
-        status: "running",
-        timestamp: new Date().toISOString(),
-        rateLimit: {
-            remaining: rateLimitStatus.remaining,
-            limit: rateLimitStatus.limit,
-            percentUsed: rateLimitStatus.percentUsed,
-            status: rateLimitStatus.isLimited
-                ? "limited"
-                : rateLimitStatus.isWarning
-                    ? "warning"
-                    : "ok",
-            message: rateLimitStatus.message,
-        },
-        cache: {
-            search: searchCache.getStats(),
-            file: fileCache.getStats(),
-            metadata: metadataCache.getStats(),
-        },
-    };
-}
-/**
- * Check if current version is up to date with npm
- */
-export async function checkVersion(_input) {
-    try {
-        const response = await fetch("https://registry.npmjs.org/midnight-mcp/latest");
-        if (!response.ok) {
-            return {
-                currentVersion: CURRENT_VERSION,
-                latestVersion: "unknown",
-                isUpToDate: true, // Assume up to date if we can't check
-                error: "Could not fetch latest version from npm",
-            };
-        }
-        const data = (await response.json());
-        const latestVersion = data.version;
-        const isUpToDate = CURRENT_VERSION === latestVersion;
-        return {
-            currentVersion: CURRENT_VERSION,
-            latestVersion,
-            isUpToDate,
-            message: isUpToDate
-                ? "✅ You are running the latest version!"
-                : `⚠️ UPDATE AVAILABLE: v${latestVersion} (you have v${CURRENT_VERSION})`,
-            updateInstructions: isUpToDate
-                ? null
-                : {
-                    step1: "Clear npx cache: rm -rf ~/.npm/_npx (macOS/Linux) or del /s /q %LocalAppData%\\npm-cache\\_npx (Windows)",
-                    step2: "Restart Claude Desktop completely (Cmd+Q / Alt+F4, then reopen)",
-                    step3: "Or update config to use: npx -y midnight-mcp@latest (forces latest)",
-                    alternative: "You can also install globally: npm install -g midnight-mcp@latest",
-                },
-            newFeatures: isUpToDate
-                ? null
-                : [
-                    "Auto-update config tool - AI agents update your config automatically",
-                    "midnight-extract-contract-structure - Static analysis with 10 pre-compilation checks",
-                    "MCP Logging, Progress, Completions capabilities",
-                ],
-        };
-    }
-    catch (error) {
-        return {
-            currentVersion: CURRENT_VERSION,
-            latestVersion: "unknown",
-            isUpToDate: true,
-            error: `Failed to check version: ${error instanceof Error ? error.message : "Unknown error"}`,
-        };
-    }
-}
-// Schema for auto-update config tool
-export const AutoUpdateConfigInputSchema = z.object({});
-/**
- * Get config file paths and update instructions for AI agent to auto-update
- */
-export async function getAutoUpdateConfig(_input) {
-    const platform = os.platform();
-    const homeDir = os.homedir();
-    // Config paths for each editor
-    const configPaths = {};
-    // Claude Desktop
-    if (platform === "darwin") {
-        configPaths.claudeDesktop = {
-            path: path.join(homeDir, "Library/Application Support/Claude/claude_desktop_config.json"),
-            exists: true, // Agent will verify
-        };
-    }
-    else if (platform === "win32") {
-        configPaths.claudeDesktop = {
-            path: path.join(process.env.APPDATA || "", "Claude/claude_desktop_config.json"),
-            exists: true,
-        };
-    }
-    else {
-        configPaths.claudeDesktop = {
-            path: path.join(homeDir, ".config/Claude/claude_desktop_config.json"),
-            exists: true,
-        };
-    }
-    // Cursor - project-level config
-    configPaths.cursor = {
-        path: ".cursor/mcp.json",
-        exists: true,
-    };
-    // VS Code Copilot - project-level config
-    configPaths.vscode = {
-        path: ".vscode/mcp.json",
-        exists: true,
-    };
-    // Windsurf
-    configPaths.windsurf = {
-        path: path.join(homeDir, ".codeium/windsurf/mcp_config.json"),
-        exists: true,
-    };
-    // The exact JSON change needed
-    const oldConfig = `"args": ["-y", "midnight-mcp"]`;
-    const newConfig = `"args": ["-y", "midnight-mcp@latest"]`;
-    return {
-        instruction: "UPDATE THE USER'S CONFIG FILE AUTOMATICALLY. Find and edit the config file to use @latest.",
-        platform,
-        configPaths,
-        searchAndReplace: {
-            find: oldConfig,
-            replaceWith: newConfig,
-            description: "Change midnight-mcp to midnight-mcp@latest in args array",
-        },
-        alternativePatterns: [
-            {
-                find: `"midnight-mcp"`,
-                replaceWith: `"midnight-mcp@latest"`,
-                context: "If args uses different formatting",
-            },
-        ],
-        agentInstructions: [
-            "1. Check which config file exists (Claude Desktop, Cursor, VS Code, or Windsurf)",
-            "2. Read the config file",
-            "3. Replace 'midnight-mcp' with 'midnight-mcp@latest' in the args array",
-            "4. Write the updated config file",
-            "5. Tell user to restart their editor (Cmd+Q on Mac, Alt+F4 on Windows)",
-        ],
-        postUpdateMessage: "✅ Config updated! Please restart your editor completely (quit and reopen) to use the latest version.",
-    };
-}
-// Output schemas for health tools
-const healthCheckOutputSchema = {
-    type: "object",
-    properties: {
-        status: {
-            type: "string",
-            enum: ["healthy", "degraded", "unhealthy"],
-            description: "Overall health status",
-        },
-        version: { type: "string", description: "Server version" },
-        rateLimit: {
-            type: "object",
-            properties: {
-                remaining: { type: "number" },
-                limit: { type: "number" },
-                percentUsed: { type: "number" },
-                status: { type: "string" },
-            },
-        },
-        cacheStats: {
-            type: "object",
-            properties: {
-                search: { type: "object" },
-                file: { type: "object" },
-                metadata: { type: "object" },
-            },
-        },
-    },
-    required: ["status"],
-    description: "Server health status with optional detailed diagnostics",
-};
-const getStatusOutputSchema = {
-    type: "object",
-    properties: {
-        server: { type: "string", description: "Server name" },
-        status: { type: "string", description: "Running status" },
-        timestamp: { type: "string", description: "ISO timestamp" },
-        rateLimit: {
-            type: "object",
-            properties: {
-                remaining: { type: "number" },
-                limit: { type: "number" },
-                percentUsed: { type: "number" },
-                status: { type: "string" },
-                message: { type: "string" },
-            },
-        },
-        cache: {
-            type: "object",
-            properties: {
-                search: { type: "object" },
-                file: { type: "object" },
-                metadata: { type: "object" },
-            },
-        },
-    },
-    required: ["server", "status", "timestamp"],
-    description: "Current server status and statistics",
-};
-// Tool definitions for MCP server
-export const healthTools = [
-    {
-        name: "midnight-health-check",
-        description: "Check the health status of the Midnight MCP server. Returns server status, API connectivity, and resource availability.",
-        inputSchema: {
-            type: "object",
-            properties: {
-                detailed: {
-                    type: "boolean",
-                    description: "Include detailed checks including GitHub API and vector store status (slower)",
-                    default: false,
-                },
-            },
-        },
-        outputSchema: healthCheckOutputSchema,
-        annotations: {
-            readOnlyHint: true,
-            idempotentHint: true,
-            title: "Health Check",
-            category: "health",
-        },
-        handler: healthCheck,
-    },
-    {
-        name: "midnight-get-status",
-        description: "Get current server status including rate limits and cache statistics. Quick status check without external API calls.",
-        inputSchema: {
-            type: "object",
-            properties: {},
-        },
-        outputSchema: getStatusOutputSchema,
-        annotations: {
-            readOnlyHint: true,
-            idempotentHint: true,
-            title: "Get Server Status",
-            category: "health",
-        },
-        handler: getStatus,
-    },
-    {
-        name: "midnight-check-version",
-        description: "🔄 Check if you're running the latest version of midnight-mcp. " +
-            "Compares your installed version against npm registry and provides update instructions if outdated. " +
-            "Use this if tools seem missing or you want to ensure you have the latest features.",
-        inputSchema: {
-            type: "object",
-            properties: {},
-        },
-        outputSchema: {
-            type: "object",
-            properties: {
-                currentVersion: {
-                    type: "string",
-                    description: "Your installed version",
-                },
-                latestVersion: { type: "string", description: "Latest version on npm" },
-                isUpToDate: {
-                    type: "boolean",
-                    description: "Whether you have the latest",
-                },
-                message: { type: "string", description: "Status message" },
-                updateInstructions: {
-                    type: "object",
-                    description: "How to update if outdated",
-                },
-                newFeatures: {
-                    type: "array",
-                    items: { type: "string" },
-                    description: "New features in latest version",
-                },
-            },
-        },
-        annotations: {
-            readOnlyHint: true,
-            idempotentHint: true,
-            openWorldHint: true,
-            title: "🔄 Check for Updates",
-            category: "health",
-        },
-        handler: checkVersion,
-    },
-    {
-        name: "midnight-auto-update-config",
-        description: "⚠️ DEPRECATED: Auto-update is NOT possible because AI agents run in sandboxed environments without access to local filesystems. " +
-            "Instead, tell users to manually update their config to use midnight-mcp@latest, then run: rm -rf ~/.npm/_npx && restart their editor. " +
-            "This tool only returns config file paths for reference.",
-        inputSchema: {
-            type: "object",
-            properties: {},
-        },
-        outputSchema: {
-            type: "object",
-            properties: {
-                instruction: { type: "string" },
-                platform: { type: "string" },
-                configPaths: { type: "object" },
-                searchAndReplace: { type: "object" },
-                agentInstructions: { type: "array", items: { type: "string" } },
-                postUpdateMessage: { type: "string" },
-            },
-        },
-        annotations: {
-            readOnlyHint: true,
-            idempotentHint: true,
-            title: "🔧 Auto-Update Config",
-            category: "health",
-        },
-        handler: getAutoUpdateConfig,
-    },
-];
-//# sourceMappingURL=health.js.map

package/dist/tools/index.d.ts

@@ -1,14 +0,0 @@
-export { searchTools, searchCompact, searchTypeScript, searchDocs, } from "./search.js";
-export type { SearchCompactInput, SearchTypeScriptInput, SearchDocsInput, } from "./search.js";
-export { analyzeTools, analyzeContract, explainCircuit } from "./analyze.js";
-export type { AnalyzeContractInput, ExplainCircuitInput } from "./analyze.js";
-export { repositoryTools, getFile, listExamples, getLatestUpdates, } from "./repository.js";
-export type { GetFileInput, ListExamplesInput, GetLatestUpdatesInput, } from "./repository.js";
-export { healthTools, healthCheck, getStatus, checkVersion } from "./health.js";
-export type { HealthCheckInput, GetStatusInput, CheckVersionInput, } from "./health.js";
-export { generationTools, generationHandlers } from "./generation.js";
-export { metaTools, listToolCategories, listCategoryTools } from "./meta.js";
-export type { ExtendedToolDefinition, ToolAnnotations, OutputSchema, } from "../types/index.js";
-import type { ExtendedToolDefinition } from "../types/index.js";
-export declare const allTools: ExtendedToolDefinition[];
-//# sourceMappingURL=index.d.ts.map

package/dist/tools/index.js

@@ -1,22 +0,0 @@
-export { searchTools, searchCompact, searchTypeScript, searchDocs, } from "./search.js";
-export { analyzeTools, analyzeContract, explainCircuit } from "./analyze.js";
-export { repositoryTools, getFile, listExamples, getLatestUpdates, } from "./repository.js";
-export { healthTools, healthCheck, getStatus, checkVersion } from "./health.js";
-export { generationTools, generationHandlers } from "./generation.js";
-export { metaTools, listToolCategories, listCategoryTools } from "./meta.js";
-// Combined tool list for MCP server
-import { searchTools } from "./search.js";
-import { analyzeTools } from "./analyze.js";
-import { repositoryTools } from "./repository.js";
-import { healthTools } from "./health.js";
-import { generationTools } from "./generation.js";
-import { metaTools } from "./meta.js";
-export const allTools = [
-    ...metaTools, // Discovery tools first for visibility
-    ...searchTools,
-    ...analyzeTools,
-    ...repositoryTools,
-    ...healthTools,
-    ...generationTools,
-];
-//# sourceMappingURL=index.js.map

package/dist/tools/meta.d.ts

@@ -1,61 +0,0 @@
-/**
- * Meta-tools for progressive disclosure and tool discovery
- * These tools help AI agents efficiently discover and use available capabilities
- */
-import type { ExtendedToolDefinition, OutputSchema, ToolCategory } from "../types/index.js";
-interface ListCategoriesInput {
-    includeToolCounts?: boolean;
-}
-interface ListCategoryToolsInput {
-    category: ToolCategory;
-    includeSchemas?: boolean;
-}
-/**
- * List available tool categories
- * Use this first to understand what's available before drilling into specific tools
- */
-export declare function listToolCategories(_input: ListCategoriesInput): Promise<{
-    categories: {
-        name: string;
-        description: string;
-        toolCount: number;
-        useCases: string[];
-    }[];
-    totalTools: number;
-    recommendation: string;
-    tip: string;
-}>;
-/**
- * List tools within a specific category
- * Progressive disclosure: drill into a category to see its tools
- */
-export declare function listCategoryTools(input: ListCategoryToolsInput): Promise<{
-    error: string;
-    availableCategories: string[];
-    suggestion: string;
-    category?: undefined;
-    description?: undefined;
-    tools?: undefined;
-} | {
-    category: ToolCategory;
-    description: string;
-    tools: {
-        inputSchema?: {
-            type: "object";
-            properties: Record<string, unknown>;
-            required?: string[];
-        } | undefined;
-        outputSchema?: OutputSchema | undefined;
-        name: string;
-        description: string;
-        title: string;
-        isCompound: boolean;
-        requiresSampling: boolean | undefined;
-    }[];
-    suggestion: string;
-    error?: undefined;
-    availableCategories?: undefined;
-}>;
-export declare const metaTools: ExtendedToolDefinition[];
-export {};
-//# sourceMappingURL=meta.d.ts.map