midnight-mcp 0.0.8 → 0.1.0

package/dist/tools/repository.js

@@ -492,6 +492,11 @@ export const repositoryTools = [
             },
             required: ["repo", "path"],
         },
+        annotations: {
+            readOnlyHint: true,
+            openWorldHint: true,
+            title: "Get Repository File",
+        },
         handler: getFile,
     },
     {
@@ -508,6 +513,11 @@ export const repositoryTools = [
             },
             required: [],
         },
+        annotations: {
+            readOnlyHint: true,
+            idempotentHint: true,
+            title: "List Example Contracts",
+        },
         handler: listExamples,
     },
     {
@@ -528,6 +538,11 @@ export const repositoryTools = [
             },
             required: [],
         },
+        annotations: {
+            readOnlyHint: true,
+            openWorldHint: true,
+            title: "Get Latest Updates",
+        },
         handler: getLatestUpdates,
     },
     {
@@ -543,6 +558,11 @@ export const repositoryTools = [
             },
             required: ["repo"],
         },
+        annotations: {
+            readOnlyHint: true,
+            openWorldHint: true,
+            title: "Get Version Info",
+        },
         handler: getVersionInfo,
     },
     {
@@ -562,6 +582,11 @@ export const repositoryTools = [
             },
             required: ["repo", "currentVersion"],
         },
+        annotations: {
+            readOnlyHint: true,
+            openWorldHint: true,
+            title: "Check Breaking Changes",
+        },
         handler: checkBreakingChanges,
     },
     {
@@ -585,6 +610,11 @@ export const repositoryTools = [
             },
             required: ["repo", "fromVersion"],
         },
+        annotations: {
+            readOnlyHint: true,
+            openWorldHint: true,
+            title: "Get Migration Guide",
+        },
         handler: getMigrationGuide,
     },
     {
@@ -608,6 +638,12 @@ export const repositoryTools = [
             },
             required: ["repo", "path", "version"],
         },
+        annotations: {
+            readOnlyHint: true,
+            idempotentHint: true,
+            openWorldHint: true,
+            title: "Get File at Version",
+        },
         handler: getFileAtVersion,
     },
     {
@@ -635,6 +671,12 @@ export const repositoryTools = [
             },
             required: ["repo", "path", "oldVersion"],
         },
+        annotations: {
+            readOnlyHint: true,
+            idempotentHint: true,
+            openWorldHint: true,
+            title: "Compare Syntax Between Versions",
+        },
         handler: compareSyntax,
     },
     {
@@ -650,6 +692,11 @@ export const repositoryTools = [
             },
             required: [],
         },
+        annotations: {
+            readOnlyHint: true,
+            openWorldHint: true,
+            title: "Get Latest Syntax Reference",
+        },
         handler: getLatestSyntax,
     },
 ];

package/dist/tools/search.d.ts

@@ -1,4 +1,5 @@
 import { z } from "zod";
+import type { ExtendedToolDefinition } from "../types/index.js";
 export declare const SearchCompactInputSchema: z.ZodObject<{
     query: z.ZodString;
     limit: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
@@ -71,92 +72,5 @@ export declare function searchTypeScript(input: SearchTypeScriptInput): Promise<
  * Full-text search across official Midnight documentation
  */
 export declare function searchDocs(input: SearchDocsInput): Promise<{}>;
-export declare const searchTools: ({
-    name: string;
-    description: string;
-    inputSchema: {
-        type: "object";
-        properties: {
-            query: {
-                type: string;
-                description: string;
-            };
-            limit: {
-                type: string;
-                description: string;
-            };
-            filter: {
-                type: string;
-                properties: {
-                    repository: {
-                        type: string;
-                    };
-                    isPublic: {
-                        type: string;
-                    };
-                };
-                description: string;
-            };
-            includeTypes?: undefined;
-            includeExamples?: undefined;
-            category?: undefined;
-        };
-        required: string[];
-    };
-    handler: typeof searchCompact;
-} | {
-    name: string;
-    description: string;
-    inputSchema: {
-        type: "object";
-        properties: {
-            query: {
-                type: string;
-                description: string;
-            };
-            includeTypes: {
-                type: string;
-                description: string;
-            };
-            includeExamples: {
-                type: string;
-                description: string;
-            };
-            limit: {
-                type: string;
-                description: string;
-            };
-            filter?: undefined;
-            category?: undefined;
-        };
-        required: string[];
-    };
-    handler: typeof searchTypeScript;
-} | {
-    name: string;
-    description: string;
-    inputSchema: {
-        type: "object";
-        properties: {
-            query: {
-                type: string;
-                description: string;
-            };
-            category: {
-                type: string;
-                enum: string[];
-                description: string;
-            };
-            limit: {
-                type: string;
-                description: string;
-            };
-            filter?: undefined;
-            includeTypes?: undefined;
-            includeExamples?: undefined;
-        };
-        required: string[];
-    };
-    handler: typeof searchDocs;
-})[];
+export declare const searchTools: ExtendedToolDefinition[];
 //# sourceMappingURL=search.d.ts.map

package/dist/tools/search.js

@@ -1,6 +1,63 @@
 import { z } from "zod";
 import { vectorStore } from "../db/index.js";
 import { logger, validateQuery, validateNumber, searchCache, createCacheKey, isHostedMode, searchCompactHosted, searchTypeScriptHosted, searchDocsHosted, } from "../utils/index.js";
+// ============================================================================
+// Common Output Schema for Search Results
+// ============================================================================
+const searchResultSchema = {
+    type: "object",
+    properties: {
+        results: {
+            type: "array",
+            description: "Array of search results",
+            items: {
+                type: "object",
+                properties: {
+                    code: { type: "string", description: "The matched code content" },
+                    relevanceScore: {
+                        type: "number",
+                        description: "Relevance score from 0 to 1",
+                    },
+                    source: {
+                        type: "object",
+                        description: "Source location information",
+                        properties: {
+                            repository: { type: "string", description: "Repository name" },
+                            filePath: { type: "string", description: "File path" },
+                            lines: {
+                                type: "string",
+                                description: "Line range (e.g., 10-50)",
+                            },
+                        },
+                    },
+                    codeType: {
+                        type: "string",
+                        description: "Type of code (compact, typescript, markdown)",
+                    },
+                    name: { type: "string", description: "Name of the code element" },
+                },
+            },
+        },
+        totalResults: {
+            type: "number",
+            description: "Total number of results returned",
+        },
+        query: { type: "string", description: "The search query used" },
+        warnings: {
+            type: "array",
+            description: "Any warnings about the search",
+            items: { type: "string" },
+        },
+    },
+    required: ["results", "totalResults", "query"],
+    description: "Search results with relevance scores and source information",
+};
+// Common annotations for search tools
+const searchToolAnnotations = {
+    readOnlyHint: true,
+    idempotentHint: true,
+    openWorldHint: true,
+};
 /**
  * Validate and prepare common search parameters
  * Extracts common validation logic used by all search functions
@@ -293,6 +350,11 @@ export const searchTools = [
             },
             required: ["query"],
         },
+        outputSchema: searchResultSchema,
+        annotations: {
+            ...searchToolAnnotations,
+            title: "Search Compact Contracts",
+        },
         handler: searchCompact,
     },
     {
@@ -320,6 +382,11 @@ export const searchTools = [
             },
             required: ["query"],
         },
+        outputSchema: searchResultSchema,
+        annotations: {
+            ...searchToolAnnotations,
+            title: "Search TypeScript SDK",
+        },
         handler: searchTypeScript,
     },
     {
@@ -344,6 +411,11 @@ export const searchTools = [
             },
             required: ["query"],
         },
+        outputSchema: searchResultSchema,
+        annotations: {
+            ...searchToolAnnotations,
+            title: "Search Documentation",
+        },
         handler: searchDocs,
     },
 ];

package/dist/types/index.d.ts

@@ -0,0 +1,2 @@
+export * from "./mcp.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/types/index.js

@@ -0,0 +1,2 @@
+export * from "./mcp.js";
+//# sourceMappingURL=index.js.map

package/dist/types/mcp.d.ts

@@ -0,0 +1,167 @@
+/**
+ * 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
+ */
+export 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;
+}
+/**
+ * JSON Schema for structured tool outputs
+ * Enables better LLM parsing and IDE integration
+ */
+export interface OutputSchema {
+    type: "object" | "array" | "string" | "number" | "boolean";
+    properties?: Record<string, PropertySchema>;
+    items?: PropertySchema;
+    required?: string[];
+    description?: string;
+}
+export interface PropertySchema {
+    type: "string" | "number" | "boolean" | "array" | "object";
+    description?: string;
+    items?: PropertySchema;
+    properties?: Record<string, PropertySchema>;
+    enum?: string[];
+}
+export interface ExtendedToolDefinition {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: Record<string, unknown>;
+        required?: string[];
+    };
+    outputSchema?: OutputSchema;
+    annotations?: ToolAnnotations;
+    handler: (input: any) => Promise<any>;
+}
+export interface ResourceTemplate {
+    /**
+     * URI template following RFC 6570
+     * e.g., "midnight://code/{owner}/{repo}/{path}"
+     */
+    uriTemplate: string;
+    /**
+     * Human-readable name
+     */
+    name: string;
+    /**
+     * Human-readable title for display
+     */
+    title?: string;
+    /**
+     * Description of what resources this template provides
+     */
+    description: string;
+    /**
+     * MIME type of resources matching this template
+     */
+    mimeType: string;
+}
+export interface ResourceAnnotations {
+    /**
+     * Intended audience for the resource
+     * "user" = for human consumption
+     * "assistant" = for LLM context
+     */
+    audience?: ("user" | "assistant")[];
+    /**
+     * Priority from 0.0 (optional) to 1.0 (required)
+     */
+    priority?: number;
+    /**
+     * ISO 8601 timestamp of last modification
+     */
+    lastModified?: string;
+}
+export interface SamplingRequest {
+    messages: SamplingMessage[];
+    systemPrompt?: string;
+    modelPreferences?: ModelPreferences;
+    maxTokens?: number;
+    temperature?: number;
+    stopSequences?: string[];
+}
+export interface SamplingMessage {
+    role: "user" | "assistant";
+    content: TextContent | ImageContent;
+}
+export interface TextContent {
+    type: "text";
+    text: string;
+}
+export interface ImageContent {
+    type: "image";
+    data: string;
+    mimeType: string;
+}
+export interface ModelPreferences {
+    hints?: {
+        name: string;
+    }[];
+    costPriority?: number;
+    speedPriority?: number;
+    intelligencePriority?: number;
+}
+export interface SamplingResponse {
+    role: "assistant";
+    content: TextContent;
+    model: string;
+    stopReason: "endTurn" | "maxTokens" | "stopSequence";
+}
+export interface SearchResult {
+    content: string;
+    relevanceScore: number;
+    source: {
+        repository: string;
+        filePath: string;
+        lines: string;
+    };
+    codeType: string;
+}
+export interface SearchResponse {
+    results: SearchResult[];
+    totalResults: number;
+    query: string;
+    warnings?: string[];
+}
+export interface AnalysisResponse {
+    name: string;
+    type: string;
+    summary: string;
+    components: {
+        name: string;
+        type: string;
+        description: string;
+    }[];
+    securityNotes: string[];
+    recommendations: string[];
+}
+//# sourceMappingURL=mcp.d.ts.map

package/dist/types/mcp.js

@@ -0,0 +1,6 @@
+/**
+ * Extended MCP types for advanced features
+ * Includes tool annotations, output schemas, and resource templates
+ */
+export {};
+//# sourceMappingURL=mcp.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "midnight-mcp",
-  "version": "0.0.8",
+  "version": "0.1.0",
   "description": "Model Context Protocol Server for Midnight Blockchain Development",
   "type": "module",
   "main": "dist/index.js",
@@ -38,7 +38,9 @@
   },
   "devDependencies": {
     "@types/node": "^20.10.0",
+    "@types/tar": "^6.1.13",
     "prettier": "^3.1.0",
+    "tar": "^7.5.2",
     "tsx": "^4.6.2",
     "typescript": "^5.3.2",
     "vitest": "^1.0.0"