midnight-mcp 0.1.41 → 0.2.2

package/dist/db-YDGUWI5K.js

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

package/dist/index.d.ts

@@ -1,3 +1,205 @@
-#!/usr/bin/env node
-export {};
-//# sourceMappingURL=index.d.ts.map
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+
+/**
+ * Initialize the server and vector store
+ */
+declare function initializeServer(): Promise<Server>;
+/**
+ * Start the server with stdio transport
+ */
+declare function startServer(): Promise<void>;
+/**
+ * Start the server with HTTP transport (SSE + Streamable HTTP)
+ */
+declare function startHttpServer(port?: number): Promise<void>;
+
+/**
+ * Extended MCP types for advanced features
+ * Includes tool annotations, output schemas, and resource templates
+ */
+/**
+ * Tool annotations provide hints about tool behavior
+ * These help clients make better decisions about tool usage
+ */
+interface ToolAnnotations {
+    /**
+     * If true, the tool does not modify any state
+     * Clients can safely retry or parallelize read-only tools
+     */
+    readOnlyHint?: boolean;
+    /**
+     * If true, calling the tool multiple times with the same input
+     * produces the same result (safe to retry)
+     */
+    idempotentHint?: boolean;
+    /**
+     * If true, the tool may return results from external sources
+     * that could change over time
+     */
+    openWorldHint?: boolean;
+    /**
+     * If true, the tool may take a long time to complete
+     * Clients should show progress indicators
+     */
+    longRunningHint?: boolean;
+    /**
+     * Human-readable title for display in UIs
+     */
+    title?: string;
+    /**
+     * If true, this tool performs destructive or irreversible actions
+     * Clients should require human confirmation before execution
+     */
+    destructiveHint?: boolean;
+    /**
+     * If true, this tool requires explicit human confirmation
+     * before execution (e.g., financial transactions, deletions)
+     */
+    requiresConfirmation?: boolean;
+    /**
+     * Tool category for progressive disclosure
+     * Allows clients to group/filter tools by domain
+     */
+    category?: ToolCategory;
+}
+/**
+ * Tool categories for progressive disclosure
+ * Clients can initially show categories, then expand to individual tools
+ */
+type ToolCategory = "search" | "analyze" | "repository" | "versioning" | "generation" | "health" | "compound";
+/**
+ * JSON Schema for structured tool outputs
+ * Enables better LLM parsing and IDE integration
+ */
+interface OutputSchema {
+    type: "object" | "array" | "string" | "number" | "boolean";
+    properties?: Record<string, PropertySchema>;
+    items?: PropertySchema;
+    required?: string[];
+    description?: string;
+}
+interface PropertySchema {
+    type: "string" | "number" | "boolean" | "array" | "object";
+    description?: string;
+    items?: PropertySchema;
+    properties?: Record<string, PropertySchema>;
+    enum?: string[];
+}
+interface ExtendedToolDefinition {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: Record<string, unknown>;
+        required?: string[];
+    };
+    outputSchema?: OutputSchema;
+    annotations?: ToolAnnotations;
+    handler: (input: any) => Promise<any>;
+}
+
+/**
+ * Tools module exports
+ * Barrel file for all MCP tools
+ */
+
+declare const allTools: ExtendedToolDefinition[];
+
+interface ResourceDefinition {
+    uri: string;
+    name: string;
+    description: string;
+    mimeType: string;
+}
+/**
+ * Get schema content by URI
+ */
+declare function getSchema(uri: string): object | null;
+
+/**
+ * Documentation resources
+ * Provides access to Midnight documentation via MCP resources
+ */
+
+/**
+ * Get documentation content by URI
+ */
+declare function getDocumentation(uri: string): Promise<string | null>;
+
+/**
+ * Code resources
+ * Provides access to Midnight code examples via MCP resources
+ */
+
+/**
+ * Get code content by URI
+ */
+declare function getCode(uri: string): Promise<string | null>;
+
+declare const allResources: ResourceDefinition[];
+
+interface PromptDefinition {
+    name: string;
+    description: string;
+    arguments: Array<{
+        name: string;
+        description: string;
+        required: boolean;
+    }>;
+}
+interface PromptMessage {
+    role: "user" | "assistant";
+    content: {
+        type: "text";
+        text: string;
+    };
+}
+declare const promptDefinitions: PromptDefinition[];
+/**
+ * Generate prompt messages based on template and arguments
+ */
+declare function generatePrompt(name: string, args: Record<string, string>): PromptMessage[];
+
+type LogLevel = "debug" | "info" | "warn" | "error";
+type LogFormat = "text" | "json";
+declare class Logger {
+    private level;
+    private format;
+    private service;
+    constructor(level?: LogLevel, format?: LogFormat, service?: string);
+    /**
+     * Set log format at runtime
+     */
+    setFormat(format: LogFormat): void;
+    /**
+     * Set log level at runtime
+     */
+    setLevel(level: LogLevel): void;
+    private shouldLog;
+    private formatTextMessage;
+    private formatJsonMessage;
+    private formatMessage;
+    debug(message: string, meta?: object): void;
+    info(message: string, meta?: object): void;
+    warn(message: string, meta?: object): void;
+    error(message: string, meta?: object): void;
+    /**
+     * Create a child logger with additional context
+     */
+    child(context: object): ChildLogger;
+}
+/**
+ * Child logger that includes additional context in all log messages
+ */
+declare class ChildLogger {
+    private parent;
+    private context;
+    constructor(parent: Logger, context: object);
+    debug(message: string, meta?: object): void;
+    info(message: string, meta?: object): void;
+    warn(message: string, meta?: object): void;
+    error(message: string, meta?: object): void;
+}
+declare const logger: Logger;
+
+export { type ExtendedToolDefinition, type OutputSchema, allResources, allTools, generatePrompt, getCode, getDocumentation, getSchema, initializeServer, logger, promptDefinitions, startHttpServer, startServer };

package/dist/index.js

@@ -1,17 +1,29 @@
-#!/usr/bin/env node
-import { startServer } from "./server.js";
-// Handle uncaught errors
-process.on("uncaughtException", (error) => {
-    console.error("Uncaught exception:", error);
-    process.exit(1);
-});
-process.on("unhandledRejection", (reason) => {
-    console.error("Unhandled rejection:", reason);
-    process.exit(1);
-});
-// Start the server
-startServer().catch((error) => {
-    console.error("Failed to start server:", error);
-    process.exit(1);
-});
+import {
+  allResources,
+  allTools,
+  generatePrompt,
+  getCode,
+  getDocumentation,
+  getSchema,
+  initializeServer,
+  promptDefinitions,
+  startHttpServer,
+  startServer
+} from "./chunk-S7G4OHA4.js";
+import {
+  logger
+} from "./chunk-HOWO4K5A.js";
+export {
+  allResources,
+  allTools,
+  generatePrompt,
+  getCode,
+  getDocumentation,
+  getSchema,
+  initializeServer,
+  logger,
+  promptDefinitions,
+  startHttpServer,
+  startServer
+};
 //# sourceMappingURL=index.js.map

package/package.json

@@ -1,20 +1,23 @@
 {
   "name": "midnight-mcp",
-  "version": "0.1.41",
+  "version": "0.2.2",
   "description": "Model Context Protocol Server for Midnight Blockchain Development",
   "type": "module",
   "main": "dist/index.js",
   "bin": {
-    "midnight-mcp": "./dist/index.js"
+    "midnight-mcp": "./dist/bin.js"
   },
   "scripts": {
-    "build": "tsc",
-    "start": "node dist/index.js",
-    "dev": "tsx watch src/index.ts",
+    "build": "tsup",
+    "typecheck": "tsc --noEmit",
+    "start": "node dist/bin.js --stdio",
+    "start:http": "node dist/bin.js --http",
+    "dev": "NODE_ENV=development tsup --watch",
     "test": "vitest",
     "test:coverage": "vitest --coverage",
     "format": "prettier --write src/**/*.ts",
-    "prepublishOnly": "npm run build"
+    "prepublishOnly": "npm run typecheck && npm run build",
+    "ci": "npm run typecheck && npm run build && npm test"
   },
   "keywords": [
     "midnight",
@@ -32,15 +35,22 @@
     "@modelcontextprotocol/sdk": "^1.0.0",
     "chromadb": "^1.8.1",
     "dotenv": "^16.3.1",
+    "express": "^5.2.1",
+    "js-yaml": "^4.1.1",
     "octokit": "^3.1.2",
     "openai": "^4.20.1",
+    "yargs": "^18.0.0",
     "zod": "^3.22.4"
   },
   "devDependencies": {
+    "@types/express": "^5.0.6",
+    "@types/js-yaml": "^4.0.9",
     "@types/node": "^20.10.0",
     "@types/tar": "^6.1.13",
+    "@types/yargs": "^17.0.35",
     "prettier": "^3.1.0",
     "tar": "^7.5.2",
+    "tsup": "^8.5.1",
     "tsx": "^4.6.2",
     "typescript": "^5.3.2",
     "vitest": "^1.0.0"

package/dist/config/compact-version.d.ts

@@ -1,183 +0,0 @@
-/**
- * Compact Language Version Configuration
- *
- * MAINTAINER: Update these values when Compact language syntax changes!
- * See docs/SYNTAX_MAINTENANCE.md for the full update checklist.
- */
-/**
- * Supported Compact language version range
- * Update when new compiler versions are released
- */
-export declare const COMPACT_VERSION: {
-    /** Minimum supported version */
-    min: string;
-    /** Maximum supported version */
-    max: string;
-    /** When this config was last updated */
-    lastUpdated: string;
-    /** Source of truth for syntax patterns */
-    referenceSource: string;
-};
-/**
- * Current pragma format that should be used in contracts
- */
-export declare const RECOMMENDED_PRAGMA: string;
-/**
- * Known deprecated patterns (add new ones here when Compact evolves)
- */
-export declare const DEPRECATED_PATTERNS: {
-    /** Deprecated in: 0.16 */
-    ledgerBlock: {
-        pattern: RegExp;
-        since: string;
-        replacement: string;
-        description: string;
-    };
-    /** Deprecated in: 0.15 */
-    cellWrapper: {
-        pattern: RegExp;
-        since: string;
-        replacement: string;
-        description: string;
-    };
-    /** Never existed */
-    voidType: {
-        pattern: RegExp;
-        since: string;
-        replacement: string;
-        description: string;
-    };
-};
-/**
- * Reference contracts known to compile successfully
- * Use these to verify syntax is still correct
- */
-export declare const REFERENCE_CONTRACTS: {
-    name: string;
-    repo: string;
-    description: string;
-}[];
-/**
- * Get the version info as a string for display
- */
-export declare function getVersionInfo(): string;
-/**
- * Check if a version is within supported range
- */
-export declare function isVersionSupported(version: string): boolean;
-/**
- * Built-in functions vs patterns you must implement yourself
- * CRITICAL: These are the actual stdlib functions available in Compact
- */
-export declare const BUILTIN_FUNCTIONS: {
-    /** Actually built into the language/stdlib */
-    stdlib: {
-        name: string;
-        signature: string;
-        description: string;
-    }[];
-    /** NOT built-in - you must implement these patterns yourself */
-    notBuiltIn: {
-        name: string;
-        wrongUsage: string;
-        correctPattern: string;
-        description: string;
-    }[];
-};
-/**
- * Type compatibility rules - what types can be compared/operated together
- */
-export declare const TYPE_COMPATIBILITY: {
-    comparisons: ({
-        types: string;
-        works: boolean;
-        note: string;
-        fix?: undefined;
-    } | {
-        types: string;
-        works: boolean;
-        fix: string;
-        note?: undefined;
-    })[];
-    arithmetic: ({
-        types: string;
-        works: boolean;
-        note: string;
-        fix?: undefined;
-    } | {
-        types: string;
-        works: boolean;
-        fix: string;
-        note?: undefined;
-    })[];
-    typeCasting: ({
-        from: string;
-        to: string;
-        direct: boolean;
-        fix: string;
-        note?: undefined;
-    } | {
-        from: string;
-        to: string;
-        direct: boolean;
-        note: string;
-        fix?: undefined;
-    })[];
-    assignments: {
-        types: string;
-        works: boolean;
-        fix: string;
-    }[];
-    tips: string[];
-};
-/**
- * Ledger type limitations - what works in circuits vs TypeScript
- */
-export declare const LEDGER_TYPE_LIMITS: {
-    Counter: {
-        circuitOperations: {
-            method: string;
-            works: boolean;
-            note: string;
-        }[];
-        typescriptAccess: string;
-        reason: string;
-    };
-    Map: {
-        circuitOperations: {
-            method: string;
-            works: boolean;
-            note: string;
-        }[];
-        typescriptAccess: string;
-        note: string;
-    };
-    Set: {
-        circuitOperations: {
-            method: string;
-            works: boolean;
-            note: string;
-        }[];
-        typescriptAccess: string;
-        note: string;
-    };
-    MerkleTree: {
-        circuitOperations: {
-            method: string;
-            works: boolean;
-            note: string;
-        }[];
-        typescriptAccess: string;
-        pattern: string;
-    };
-};
-/**
- * Common compilation errors with their fixes
- * Maps actual compiler error messages to solutions
- */
-export declare const COMMON_ERRORS: {
-    error: string;
-    cause: string;
-    fix: string;
-}[];
-//# sourceMappingURL=compact-version.d.ts.map