midnight-mcp 0.1.40 → 0.2.1

package/dist/tools/meta.js

@@ -1,282 +0,0 @@
-/**
- * Meta-tools for progressive disclosure and tool discovery
- * These tools help AI agents efficiently discover and use available capabilities
- */
-// Import all tool arrays to build the index
-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";
-// ============================================================================
-// Tool Category Descriptions
-// ============================================================================
-const CATEGORY_INFO = {
-    search: {
-        description: "Semantic search across Midnight codebase - find code by meaning, not keywords",
-        useCases: [
-            "Find example implementations",
-            "Search for patterns",
-            "Discover relevant code",
-        ],
-    },
-    analyze: {
-        description: "Static analysis of Compact contracts - security, structure, patterns",
-        useCases: [
-            "Security audit",
-            "Code review",
-            "Understand contract structure",
-        ],
-    },
-    repository: {
-        description: "Access repository files, examples, and recent updates",
-        useCases: [
-            "Get specific files",
-            "List examples",
-            "Track repository changes",
-        ],
-    },
-    versioning: {
-        description: "Version management, breaking changes, and migration assistance",
-        useCases: [
-            "Check for updates",
-            "Plan upgrades",
-            "Compare versions",
-            "Get migration guides",
-        ],
-    },
-    generation: {
-        description: "AI-powered code generation, review, and documentation (requires sampling)",
-        useCases: ["Generate contracts", "Review code", "Generate documentation"],
-    },
-    health: {
-        description: "Server health checks and status monitoring",
-        useCases: ["Check API status", "Monitor rate limits", "Debug connectivity"],
-    },
-    compound: {
-        description: "Multi-step operations in a single call - saves tokens and reduces latency",
-        useCases: [
-            "Full upgrade analysis",
-            "Get complete repo context",
-            "One-shot operations",
-        ],
-    },
-};
-const listCategoriesOutputSchema = {
-    type: "object",
-    properties: {
-        categories: {
-            type: "array",
-            description: "Available tool categories",
-            items: {
-                type: "object",
-                properties: {
-                    name: { type: "string", description: "Category identifier" },
-                    description: {
-                        type: "string",
-                        description: "What the category does",
-                    },
-                    toolCount: { type: "number", description: "Number of tools" },
-                    useCases: {
-                        type: "array",
-                        description: "When to use this category",
-                        items: { type: "string" },
-                    },
-                },
-            },
-        },
-        totalTools: { type: "number", description: "Total tool count" },
-        recommendation: {
-            type: "string",
-            description: "Suggested starting point",
-        },
-    },
-    required: ["categories", "totalTools"],
-    description: "Tool categories for progressive discovery",
-};
-const listCategoryToolsOutputSchema = {
-    type: "object",
-    properties: {
-        category: { type: "string", description: "Category name" },
-        tools: {
-            type: "array",
-            description: "Tools in this category",
-            items: {
-                type: "object",
-                properties: {
-                    name: { type: "string", description: "Tool name" },
-                    description: { type: "string", description: "What the tool does" },
-                    title: { type: "string", description: "Human-readable title" },
-                    isCompound: {
-                        type: "boolean",
-                        description: "Whether this is a compound tool",
-                    },
-                    requiresSampling: {
-                        type: "boolean",
-                        description: "Requires client sampling capability",
-                    },
-                },
-            },
-        },
-        suggestion: { type: "string", description: "Usage suggestion" },
-    },
-    required: ["category", "tools"],
-    description: "Tools within a specific category",
-};
-// ============================================================================
-// Handler Functions
-// ============================================================================
-// Build tool index by category
-function getToolsByCategory() {
-    const allTools = [
-        ...searchTools,
-        ...analyzeTools,
-        ...repositoryTools,
-        ...healthTools,
-        ...generationTools,
-        ...metaTools,
-    ];
-    const byCategory = new Map();
-    for (const tool of allTools) {
-        const category = tool.annotations?.category || "repository";
-        if (!byCategory.has(category)) {
-            byCategory.set(category, []);
-        }
-        byCategory.get(category).push(tool);
-    }
-    return byCategory;
-}
-/**
- * List available tool categories
- * Use this first to understand what's available before drilling into specific tools
- */
-export async function listToolCategories(_input) {
-    const toolsByCategory = getToolsByCategory();
-    const categories = Object.entries(CATEGORY_INFO).map(([name, info]) => ({
-        name,
-        description: info.description,
-        toolCount: toolsByCategory.get(name)?.length || 0,
-        useCases: info.useCases,
-    }));
-    // Filter out empty categories
-    const nonEmptyCategories = categories.filter((c) => c.toolCount > 0);
-    const totalTools = nonEmptyCategories.reduce((sum, c) => sum + c.toolCount, 0);
-    return {
-        categories: nonEmptyCategories,
-        totalTools,
-        recommendation: "Start with 'compound' category for efficient multi-step operations, or 'search' to find relevant code.",
-        tip: "Use midnight-list-category-tools to see tools within a specific category.",
-    };
-}
-/**
- * List tools within a specific category
- * Progressive disclosure: drill into a category to see its tools
- */
-export async function listCategoryTools(input) {
-    const toolsByCategory = getToolsByCategory();
-    const tools = toolsByCategory.get(input.category) || [];
-    if (tools.length === 0) {
-        return {
-            error: `Unknown or empty category: ${input.category}`,
-            availableCategories: Object.keys(CATEGORY_INFO),
-            suggestion: "Use midnight-list-tool-categories to see available categories.",
-        };
-    }
-    const categoryInfo = CATEGORY_INFO[input.category];
-    return {
-        category: input.category,
-        description: categoryInfo.description,
-        tools: tools.map((t) => ({
-            name: t.name,
-            description: t.description.split("\n")[0], // First line only
-            title: t.annotations?.title || t.name,
-            isCompound: t.annotations?.category === "compound",
-            requiresSampling: t.annotations?.longRunningHint &&
-                t.annotations?.category === "generation",
-            ...(input.includeSchemas && {
-                inputSchema: t.inputSchema,
-                outputSchema: t.outputSchema,
-            }),
-        })),
-        suggestion: generateCategorySuggestion(input.category),
-    };
-}
-function generateCategorySuggestion(category) {
-    switch (category) {
-        case "compound":
-            return "🚀 Compound tools save 50-70% tokens. Use midnight-upgrade-check or midnight-get-repo-context for efficient operations.";
-        case "search":
-            return "💡 Search tools use semantic matching - describe what you want in natural language.";
-        case "generation":
-            return "⚠️ Generation tools require sampling capability. They use the client's LLM for AI-powered operations.";
-        case "versioning":
-            return "📦 For version checks, prefer midnight-upgrade-check (compound) over individual version tools.";
-        case "analyze":
-            return "🔍 Analyze tools work on Compact code. Provide the contract source code directly.";
-        default:
-            return `Use these tools for ${CATEGORY_INFO[category]?.useCases[0] || "related operations"}.`;
-    }
-}
-// ============================================================================
-// Tool Definitions
-// ============================================================================
-export const metaTools = [
-    {
-        name: "midnight-list-tool-categories",
-        description: "📋 DISCOVERY TOOL: List available tool categories for progressive exploration. Use this FIRST to understand what capabilities are available, then drill into specific categories with midnight-list-category-tools. Reduces cognitive load by organizing 25 tools into 7 logical groups.",
-        inputSchema: {
-            type: "object",
-            properties: {
-                includeToolCounts: {
-                    type: "boolean",
-                    description: "Include number of tools per category (default: true)",
-                },
-            },
-            required: [],
-        },
-        outputSchema: listCategoriesOutputSchema,
-        annotations: {
-            readOnlyHint: true,
-            idempotentHint: true,
-            title: "📋 List Tool Categories",
-            category: "health",
-        },
-        handler: listToolCategories,
-    },
-    {
-        name: "midnight-list-category-tools",
-        description: "📋 DISCOVERY TOOL: List tools within a specific category. Use after midnight-list-tool-categories to see detailed tool information for a category of interest. Supports progressive disclosure pattern.",
-        inputSchema: {
-            type: "object",
-            properties: {
-                category: {
-                    type: "string",
-                    enum: [
-                        "search",
-                        "analyze",
-                        "repository",
-                        "versioning",
-                        "generation",
-                        "health",
-                        "compound",
-                    ],
-                    description: "Category to list tools for",
-                },
-                includeSchemas: {
-                    type: "boolean",
-                    description: "Include input/output schemas (default: false)",
-                },
-            },
-            required: ["category"],
-        },
-        outputSchema: listCategoryToolsOutputSchema,
-        annotations: {
-            readOnlyHint: true,
-            idempotentHint: true,
-            title: "📋 List Category Tools",
-            category: "health",
-        },
-        handler: listCategoryTools,
-    },
-];
-//# sourceMappingURL=meta.js.map

package/dist/tools/repository/constants.d.ts

@@ -1,19 +0,0 @@
-/**
- * Repository constants
- * Aliases, example definitions, and configuration data
- */
-export declare const REPO_ALIASES: Record<string, {
-    owner: string;
-    repo: string;
-}>;
-export interface ExampleDefinition {
-    name: string;
-    repository: string;
-    description: string;
-    category: string;
-    complexity: "beginner" | "intermediate" | "advanced";
-    mainFile: string;
-    features: string[];
-}
-export declare const EXAMPLES: ExampleDefinition[];
-//# sourceMappingURL=constants.d.ts.map

package/dist/tools/repository/constants.js

@@ -1,324 +0,0 @@
-/**
- * Repository constants
- * Aliases, example definitions, and configuration data
- */
-// Repository name mapping
-export const REPO_ALIASES = {
-    // Core Language & SDK
-    compact: { owner: "midnightntwrk", repo: "compact" },
-    "midnight-js": { owner: "midnightntwrk", repo: "midnight-js" },
-    js: { owner: "midnightntwrk", repo: "midnight-js" },
-    sdk: { owner: "midnightntwrk", repo: "midnight-js" },
-    // Documentation
-    docs: { owner: "midnightntwrk", repo: "midnight-docs" },
-    "midnight-docs": { owner: "midnightntwrk", repo: "midnight-docs" },
-    // Example DApps
-    "example-counter": { owner: "midnightntwrk", repo: "example-counter" },
-    counter: { owner: "midnightntwrk", repo: "example-counter" },
-    "example-bboard": { owner: "midnightntwrk", repo: "example-bboard" },
-    bboard: { owner: "midnightntwrk", repo: "example-bboard" },
-    "example-dex": { owner: "midnightntwrk", repo: "example-dex" },
-    dex: { owner: "midnightntwrk", repo: "example-dex" },
-    // Developer Tools
-    "create-mn-app": { owner: "midnightntwrk", repo: "create-mn-app" },
-    "midnight-wallet": { owner: "midnightntwrk", repo: "midnight-wallet" },
-    wallet: { owner: "midnightntwrk", repo: "midnight-wallet" },
-    // Infrastructure
-    "midnight-indexer": { owner: "midnightntwrk", repo: "midnight-indexer" },
-    indexer: { owner: "midnightntwrk", repo: "midnight-indexer" },
-    "midnight-node-docker": {
-        owner: "midnightntwrk",
-        repo: "midnight-node-docker",
-    },
-    node: { owner: "midnightntwrk", repo: "midnight-node-docker" },
-    // APIs & Connectors
-    "midnight-dapp-connector-api": {
-        owner: "midnightntwrk",
-        repo: "midnight-dapp-connector-api",
-    },
-    connector: { owner: "midnightntwrk", repo: "midnight-dapp-connector-api" },
-    // Tooling
-    "compact-tree-sitter": {
-        owner: "midnightntwrk",
-        repo: "compact-tree-sitter",
-    },
-    "tree-sitter": { owner: "midnightntwrk", repo: "compact-tree-sitter" },
-    "setup-compact-action": {
-        owner: "midnightntwrk",
-        repo: "setup-compact-action",
-    },
-    "setup-compact": { owner: "midnightntwrk", repo: "setup-compact-action" },
-    "compact-action": { owner: "midnightntwrk", repo: "setup-compact-action" },
-    // Community
-    "midnight-awesome-dapps": {
-        owner: "midnightntwrk",
-        repo: "midnight-awesome-dapps",
-    },
-    awesome: { owner: "midnightntwrk", repo: "midnight-awesome-dapps" },
-    "contributor-hub": { owner: "midnightntwrk", repo: "contributor-hub" },
-    // Partner Libraries (OpenZeppelin)
-    "compact-contracts": { owner: "OpenZeppelin", repo: "compact-contracts" },
-    openzeppelin: { owner: "OpenZeppelin", repo: "compact-contracts" },
-    oz: { owner: "OpenZeppelin", repo: "compact-contracts" },
-    "midnight-apps": { owner: "OpenZeppelin", repo: "midnight-apps" },
-    lunarswap: { owner: "OpenZeppelin", repo: "midnight-apps" },
-    // Official Partners (from awesome-dapps)
-    "midnight-seabattle": { owner: "bricktowers", repo: "midnight-seabattle" },
-    seabattle: { owner: "bricktowers", repo: "midnight-seabattle" },
-    battleship: { owner: "bricktowers", repo: "midnight-seabattle" },
-    "midnight-identity": { owner: "bricktowers", repo: "midnight-identity" },
-    identity: { owner: "bricktowers", repo: "midnight-identity" },
-    "midnight-rwa": { owner: "bricktowers", repo: "midnight-rwa" },
-    rwa: { owner: "bricktowers", repo: "midnight-rwa" },
-    "midnight-starter-template": {
-        owner: "MeshJS",
-        repo: "midnight-starter-template",
-    },
-    meshjs: { owner: "MeshJS", repo: "midnight-starter-template" },
-    starter: { owner: "MeshJS", repo: "midnight-starter-template" },
-    midnames: { owner: "midnames", repo: "core" },
-    did: { owner: "midnames", repo: "core" },
-    // Sea Battle Hackathon Winners (Feb 2025)
-    "naval-battle": { owner: "ErickRomeroDev", repo: "naval-battle-game_v2" },
-    "edda-labs": { owner: "ErickRomeroDev", repo: "naval-battle-game_v2" },
-    "sea-battle-hackathon": {
-        owner: "eddex",
-        repo: "midnight-sea-battle-hackathon",
-    },
-    shipyspace: { owner: "eddex", repo: "midnight-sea-battle-hackathon" },
-    // Core Partner - PaimaStudios (Gaming Infrastructure)
-    "midnight-game-2": { owner: "PaimaStudios", repo: "midnight-game-2" },
-    "paima-game": { owner: "PaimaStudios", repo: "midnight-game-2" },
-    "dust-to-dust": { owner: "PaimaStudios", repo: "midnight-game-2" },
-    "midnight-wasm-prover": {
-        owner: "PaimaStudios",
-        repo: "midnight-wasm-prover",
-    },
-    "wasm-prover": { owner: "PaimaStudios", repo: "midnight-wasm-prover" },
-    "midnight-batcher": { owner: "PaimaStudios", repo: "midnight-batcher" },
-    batcher: { owner: "PaimaStudios", repo: "midnight-batcher" },
-    "midnight-impact-rps": {
-        owner: "PaimaStudios",
-        repo: "midnight-impact-rps-example",
-    },
-    "impact-rps": { owner: "PaimaStudios", repo: "midnight-impact-rps-example" },
-    "vm-bindings": { owner: "PaimaStudios", repo: "midnight-impact-rps-example" },
-    // Mini DApp Hackathon Winners (Sep 2025)
-    statera: { owner: "statera-protocol", repo: "statera-protocol-midnight" },
-    "statera-protocol": {
-        owner: "statera-protocol",
-        repo: "statera-protocol-midnight",
-    },
-    lucentlabs: { owner: "statera-protocol", repo: "statera-protocol-midnight" },
-    stablecoin: { owner: "statera-protocol", repo: "statera-protocol-midnight" },
-    "midnight-bank": { owner: "nel349", repo: "midnight-bank" },
-    bank: { owner: "nel349", repo: "midnight-bank" },
-    zkbadge: { owner: "Imdavyking", repo: "zkbadge" },
-    badge: { owner: "Imdavyking", repo: "zkbadge" },
-    davyking: { owner: "Imdavyking", repo: "zkbadge" },
-};
-export const EXAMPLES = [
-    {
-        name: "Counter",
-        repository: "midnightntwrk/example-counter",
-        description: "Simple counter contract demonstrating basic Compact concepts. Perfect for learning ledger state, circuits, and witnesses.",
-        category: "counter",
-        complexity: "beginner",
-        mainFile: "contract/src/counter.compact",
-        features: [
-            "Ledger state management",
-            "Basic circuit definition",
-            "Counter increment/decrement",
-            "TypeScript integration",
-        ],
-    },
-    {
-        name: "Bulletin Board",
-        repository: "midnightntwrk/example-bboard",
-        description: "Full DApp example with CLI and React UI. Demonstrates posting messages with privacy features.",
-        category: "bboard",
-        complexity: "intermediate",
-        mainFile: "contract/src/bboard.compact",
-        features: [
-            "Private messaging",
-            "React frontend",
-            "CLI interface",
-            "Wallet integration",
-            "Disclose operations",
-        ],
-    },
-    {
-        name: "DEX (Decentralized Exchange)",
-        repository: "midnightntwrk/example-dex",
-        description: "Advanced DApp example showing token swaps and liquidity pools with privacy-preserving transactions.",
-        category: "dex",
-        complexity: "advanced",
-        mainFile: "contract/src/dex.compact",
-        features: [
-            "Token swaps",
-            "Liquidity pools",
-            "Privacy-preserving trades",
-            "Price calculations",
-            "Advanced state management",
-        ],
-    },
-    // Sea Battle Hackathon Winners (Feb 2025)
-    {
-        name: "Sea Battle (Brick Towers)",
-        repository: "bricktowers/midnight-seabattle",
-        description: "1st place hackathon winner. Fully playable battleship game with token staking (100 shielded tBTC). Features ZK-protected ship placements and moves.",
-        category: "game",
-        complexity: "advanced",
-        mainFile: "contract/src/seabattle.compact",
-        features: [
-            "ZK game mechanics",
-            "Shielded token staking",
-            "Turn-based gameplay",
-            "Private state management",
-            "Lace wallet integration",
-        ],
-    },
-    {
-        name: "Naval Battle (Edda Labs)",
-        repository: "ErickRomeroDev/naval-battle-game_v2",
-        description: "2nd place hackathon winner. Clean implementation with 4 ZK circuits: join game, commit grid, start game, make move. Modern drag-and-drop UI.",
-        category: "game",
-        complexity: "intermediate",
-        mainFile: "contract/src/naval.compact",
-        features: [
-            "4 ZK circuits",
-            "Drag-and-drop UI",
-            "Real-time updates",
-            "Clean circuit design",
-            "Open-source docs",
-        ],
-    },
-    {
-        name: "Sea Battle (ShipySpace)",
-        repository: "eddex/midnight-sea-battle-hackathon",
-        description: "3rd place hackathon winner. Great beginner-friendly example showing core game mechanics without centralized server. Good first ZK project reference.",
-        category: "game",
-        complexity: "beginner",
-        mainFile: "contract/src/game.compact",
-        features: [
-            "No centralized server",
-            "Deploy/join/resume games",
-            "Basic ZK patterns",
-            "Beginner friendly",
-            "Clear player interactions",
-        ],
-    },
-    // Mini DApp Hackathon Winners (Sep 2025)
-    {
-        name: "Statera Protocol (LucentLabs)",
-        repository: "statera-protocol/statera-protocol-midnight",
-        description: "1st place Mini DApp winner. Private overcollateralized stablecoin with shielded liquidations. Institutional-grade DeFi with KYC compliance and full transaction privacy.",
-        category: "defi",
-        complexity: "advanced",
-        mainFile: "contract/src/statera.compact",
-        features: [
-            "Shielded stablecoin",
-            "Automated liquidations",
-            "Off-chain KYC",
-            "Private minting/staking",
-            "Institutional DeFi",
-        ],
-    },
-    {
-        name: "Midnight Bank",
-        repository: "nel349/midnight-bank",
-        description: "2nd place Mini DApp winner. Private banking DApp demonstrating prove/hide/compute/reveal patterns. Shared accounts with PIN, multi-party authorization, and selective disclosure.",
-        category: "defi",
-        complexity: "intermediate",
-        mainFile: "contract/src/bank.compact",
-        features: [
-            "Encrypted balances",
-            "PIN-protected accounts",
-            "Multi-party auth",
-            "Selective disclosure",
-            "Private transfers",
-        ],
-    },
-    {
-        name: "zkBadge (Davyking)",
-        repository: "Imdavyking/zkbadge",
-        description: "3rd place Mini DApp winner. Privacy-preserving identity and access control. Issue verifiable credentials (e.g., age proof) without revealing personal data. Only 'verified' status stored on-chain.",
-        category: "identity",
-        complexity: "intermediate",
-        mainFile: "contract/src/zkbadge.compact",
-        features: [
-            "ZK credentials",
-            "Off-chain verification",
-            "On-chain badges",
-            "Access control",
-            "Reputation system",
-        ],
-    },
-    // Core Partner - PaimaStudios (Gaming Infrastructure)
-    {
-        name: "Midnight Game 2 (PaimaStudios)",
-        repository: "PaimaStudios/midnight-game-2",
-        description: "Full production game from core Midnight partner. Complete Phaser frontend, CLI admin tools, and batcher integration. Demonstrates advanced game mechanics with battles, quests, spirits, and upgrades using ZK proofs.",
-        category: "game",
-        complexity: "advanced",
-        mainFile: "contract/src/template.compact",
-        features: [
-            "Phaser game frontend",
-            "Batcher mode (no wallet needed)",
-            "Admin CLI tools",
-            "Battle system circuits",
-            "Quest mechanics",
-            "Spirit upgrades",
-            "Code generation for circuits",
-        ],
-    },
-    {
-        name: "WASM Prover (PaimaStudios)",
-        repository: "PaimaStudios/midnight-wasm-prover",
-        description: "Browser-based WASM ZK prover for Midnight transactions. Enables client-side proving without external services. Essential infrastructure for decentralized DApps.",
-        category: "infrastructure",
-        complexity: "advanced",
-        mainFile: "src/lib.rs",
-        features: [
-            "Browser-based proving",
-            "Multi-threaded WASM",
-            "WebWorker integration",
-            "KZG trusted setup handling",
-            "No server dependency",
-            "Webpack demo included",
-        ],
-    },
-    {
-        name: "Midnight Batcher (PaimaStudios)",
-        repository: "PaimaStudios/midnight-batcher",
-        description: "Transaction batching service for Midnight. Enables wallet-less DApp interactions by handling transaction fees and submission. Production-ready Rust implementation.",
-        category: "infrastructure",
-        complexity: "advanced",
-        mainFile: "src/main.rs",
-        features: [
-            "Wallet-less transactions",
-            "Fee sponsorship",
-            "Contract whitelisting",
-            "Pre-proving service",
-            "WebSocket indexer sync",
-            "Local chain setup scripts",
-        ],
-    },
-    {
-        name: "Impact VM RPS Example (PaimaStudios)",
-        repository: "PaimaStudios/midnight-impact-rps-example",
-        description: "Low-level Impact VM programming example. Shows how to write Midnight contracts without Compact, directly using Impact opcodes and zkir. Rock-Paper-Scissors with commitment schemes.",
-        category: "infrastructure",
-        complexity: "advanced",
-        mainFile: "lib/src/lib.rs",
-        features: [
-            "Impact VM direct programming",
-            "Bypass Compact compiler",
-            "zkir circuit building",
-            "Commitment schemes",
-            "TypeScript WASM bindings",
-            "Full RPS game logic",
-        ],
-    },
-];
-//# sourceMappingURL=constants.js.map