midnight-mcp 0.1.40 → 0.2.1

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 };