midnight-mcp 0.1.0 → 0.1.2

package/dist/tools/repository/tools.js

@@ -0,0 +1,237 @@
+/**
+ * Repository tool definitions
+ * MCP tool registration for repository-related operations
+ */
+import { getFile, listExamples, getLatestUpdates, getVersionInfo, checkBreakingChanges, getMigrationGuide, getFileAtVersion, compareSyntax, getLatestSyntax, } from "./handlers.js";
+// Tool definitions for MCP
+export const repositoryTools = [
+    {
+        name: "midnight-get-file",
+        description: "Retrieve a specific file from Midnight repositories. Use repository aliases like 'compact', 'midnight-js', 'counter', or 'bboard' for convenience.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                repo: {
+                    type: "string",
+                    description: "Repository name (e.g., 'compact', 'midnight-js', 'example-counter')",
+                },
+                path: {
+                    type: "string",
+                    description: "File path within repository",
+                },
+                ref: {
+                    type: "string",
+                    description: "Branch, tag, or commit SHA (default: main)",
+                },
+            },
+            required: ["repo", "path"],
+        },
+        annotations: {
+            readOnlyHint: true,
+            openWorldHint: true,
+            title: "Get Repository File",
+        },
+        handler: getFile,
+    },
+    {
+        name: "midnight-list-examples",
+        description: "List available Midnight example contracts and DApps with descriptions, complexity ratings, and key features.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                category: {
+                    type: "string",
+                    enum: ["counter", "bboard", "token", "voting", "all"],
+                    description: "Filter by example type (default: all)",
+                },
+            },
+            required: [],
+        },
+        annotations: {
+            readOnlyHint: true,
+            idempotentHint: true,
+            title: "List Example Contracts",
+        },
+        handler: listExamples,
+    },
+    {
+        name: "midnight-get-latest-updates",
+        description: "Retrieve recent changes and commits across Midnight repositories. Useful for staying up-to-date with the latest developments.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                since: {
+                    type: "string",
+                    description: "ISO date to fetch updates from (default: last 7 days)",
+                },
+                repos: {
+                    type: "array",
+                    items: { type: "string" },
+                    description: "Specific repos to check (default: all configured repos)",
+                },
+            },
+            required: [],
+        },
+        annotations: {
+            readOnlyHint: true,
+            openWorldHint: true,
+            title: "Get Latest Updates",
+        },
+        handler: getLatestUpdates,
+    },
+    {
+        name: "midnight-get-version-info",
+        description: "Get the latest version, release notes, and recent breaking changes for a Midnight repository. Use this to ensure you're working with the latest implementation.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                repo: {
+                    type: "string",
+                    description: "Repository name (e.g., 'compact', 'midnight-js', 'sdk')",
+                },
+            },
+            required: ["repo"],
+        },
+        annotations: {
+            readOnlyHint: true,
+            openWorldHint: true,
+            title: "Get Version Info",
+        },
+        handler: getVersionInfo,
+    },
+    {
+        name: "midnight-check-breaking-changes",
+        description: "Check if there are breaking changes between your current version and the latest release. Essential before upgrading dependencies.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                repo: {
+                    type: "string",
+                    description: "Repository name (e.g., 'compact', 'midnight-js')",
+                },
+                currentVersion: {
+                    type: "string",
+                    description: "Version you're currently using (e.g., 'v1.0.0', '0.5.2')",
+                },
+            },
+            required: ["repo", "currentVersion"],
+        },
+        annotations: {
+            readOnlyHint: true,
+            openWorldHint: true,
+            title: "Check Breaking Changes",
+        },
+        handler: checkBreakingChanges,
+    },
+    {
+        name: "midnight-get-migration-guide",
+        description: "Get a detailed migration guide for upgrading between versions, including all breaking changes, deprecations, and recommended steps.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                repo: {
+                    type: "string",
+                    description: "Repository name (e.g., 'compact', 'midnight-js')",
+                },
+                fromVersion: {
+                    type: "string",
+                    description: "Version you're migrating from",
+                },
+                toVersion: {
+                    type: "string",
+                    description: "Target version (default: latest stable)",
+                },
+            },
+            required: ["repo", "fromVersion"],
+        },
+        annotations: {
+            readOnlyHint: true,
+            openWorldHint: true,
+            title: "Get Migration Guide",
+        },
+        handler: getMigrationGuide,
+    },
+    {
+        name: "midnight-get-file-at-version",
+        description: "Get the exact content of a file at a specific version. CRITICAL: Use this to ensure code recommendations match the user's version. Always prefer this over get-file when version accuracy matters.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                repo: {
+                    type: "string",
+                    description: "Repository name (e.g., 'compact', 'midnight-js')",
+                },
+                path: {
+                    type: "string",
+                    description: "File path within repository",
+                },
+                version: {
+                    type: "string",
+                    description: "Version tag (e.g., 'v1.0.0') or branch (e.g., 'main')",
+                },
+            },
+            required: ["repo", "path", "version"],
+        },
+        annotations: {
+            readOnlyHint: true,
+            idempotentHint: true,
+            openWorldHint: true,
+            title: "Get File at Version",
+        },
+        handler: getFileAtVersion,
+    },
+    {
+        name: "midnight-compare-syntax",
+        description: "Compare a file between two versions to see what changed. Use this before recommending code patterns to ensure they work with the user's version.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                repo: {
+                    type: "string",
+                    description: "Repository name (e.g., 'compact')",
+                },
+                path: {
+                    type: "string",
+                    description: "File path to compare",
+                },
+                oldVersion: {
+                    type: "string",
+                    description: "Old version tag (e.g., 'v0.9.0')",
+                },
+                newVersion: {
+                    type: "string",
+                    description: "New version tag (default: latest stable)",
+                },
+            },
+            required: ["repo", "path", "oldVersion"],
+        },
+        annotations: {
+            readOnlyHint: true,
+            idempotentHint: true,
+            openWorldHint: true,
+            title: "Compare Syntax Between Versions",
+        },
+        handler: compareSyntax,
+    },
+    {
+        name: "midnight-get-latest-syntax",
+        description: "Get the authoritative syntax reference for Compact language at the latest version. Use this as the source of truth when writing or reviewing contracts to ensure they compile.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                repo: {
+                    type: "string",
+                    description: "Repository name (default: 'compact')",
+                },
+            },
+            required: [],
+        },
+        annotations: {
+            readOnlyHint: true,
+            openWorldHint: true,
+            title: "Get Latest Syntax Reference",
+        },
+        handler: getLatestSyntax,
+    },
+];
+//# sourceMappingURL=tools.js.map

package/dist/tools/repository.d.ts

@@ -1,276 +1,6 @@
-import { z } from "zod";
-import type { ExtendedToolDefinition } from "../types/index.js";
-export declare const GetFileInputSchema: z.ZodObject<{
-    repo: z.ZodString;
-    path: z.ZodString;
-    ref: z.ZodOptional<z.ZodString>;
-}, "strip", z.ZodTypeAny, {
-    path: string;
-    repo: string;
-    ref?: string | undefined;
-}, {
-    path: string;
-    repo: string;
-    ref?: string | undefined;
-}>;
-export declare const ListExamplesInputSchema: z.ZodObject<{
-    category: z.ZodDefault<z.ZodOptional<z.ZodEnum<["counter", "bboard", "token", "voting", "all"]>>>;
-}, "strip", z.ZodTypeAny, {
-    category: "all" | "counter" | "bboard" | "token" | "voting";
-}, {
-    category?: "all" | "counter" | "bboard" | "token" | "voting" | undefined;
-}>;
-export declare const GetLatestUpdatesInputSchema: z.ZodObject<{
-    since: z.ZodOptional<z.ZodString>;
-    repos: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
-}, "strip", z.ZodTypeAny, {
-    repos?: string[] | undefined;
-    since?: string | undefined;
-}, {
-    repos?: string[] | undefined;
-    since?: string | undefined;
-}>;
-export declare const GetVersionInfoInputSchema: z.ZodObject<{
-    repo: z.ZodString;
-}, "strip", z.ZodTypeAny, {
-    repo: string;
-}, {
-    repo: string;
-}>;
-export declare const CheckBreakingChangesInputSchema: z.ZodObject<{
-    repo: z.ZodString;
-    currentVersion: z.ZodString;
-}, "strip", z.ZodTypeAny, {
-    repo: string;
-    currentVersion: string;
-}, {
-    repo: string;
-    currentVersion: string;
-}>;
-export declare const GetMigrationGuideInputSchema: z.ZodObject<{
-    repo: z.ZodString;
-    fromVersion: z.ZodString;
-    toVersion: z.ZodOptional<z.ZodString>;
-}, "strip", z.ZodTypeAny, {
-    repo: string;
-    fromVersion: string;
-    toVersion?: string | undefined;
-}, {
-    repo: string;
-    fromVersion: string;
-    toVersion?: string | undefined;
-}>;
-export declare const GetFileAtVersionInputSchema: z.ZodObject<{
-    repo: z.ZodString;
-    path: z.ZodString;
-    version: z.ZodString;
-}, "strip", z.ZodTypeAny, {
-    path: string;
-    repo: string;
-    version: string;
-}, {
-    path: string;
-    repo: string;
-    version: string;
-}>;
-export declare const CompareSyntaxInputSchema: z.ZodObject<{
-    repo: z.ZodString;
-    path: z.ZodString;
-    oldVersion: z.ZodString;
-    newVersion: z.ZodOptional<z.ZodString>;
-}, "strip", z.ZodTypeAny, {
-    path: string;
-    repo: string;
-    oldVersion: string;
-    newVersion?: string | undefined;
-}, {
-    path: string;
-    repo: string;
-    oldVersion: string;
-    newVersion?: string | undefined;
-}>;
-export declare const GetLatestSyntaxInputSchema: z.ZodObject<{
-    repo: z.ZodDefault<z.ZodString>;
-}, "strip", z.ZodTypeAny, {
-    repo: string;
-}, {
-    repo?: string | undefined;
-}>;
-export type GetFileInput = z.infer<typeof GetFileInputSchema>;
-export type ListExamplesInput = z.infer<typeof ListExamplesInputSchema>;
-export type GetLatestUpdatesInput = z.infer<typeof GetLatestUpdatesInputSchema>;
-export type GetVersionInfoInput = z.infer<typeof GetVersionInfoInputSchema>;
-export type CheckBreakingChangesInput = z.infer<typeof CheckBreakingChangesInputSchema>;
-export type GetMigrationGuideInput = z.infer<typeof GetMigrationGuideInputSchema>;
-export type GetFileAtVersionInput = z.infer<typeof GetFileAtVersionInputSchema>;
-export type CompareSyntaxInput = z.infer<typeof CompareSyntaxInputSchema>;
-export type GetLatestSyntaxInput = z.infer<typeof GetLatestSyntaxInputSchema>;
 /**
- * Retrieve a specific file from Midnight repositories
+ * Repository tools
+ * Re-exports from modular structure for backward compatibility
  */
-export declare function getFile(input: GetFileInput): Promise<{
-    error: string;
-    suggestion: string;
-    repository?: undefined;
-    content?: undefined;
-    path?: undefined;
-    sha?: undefined;
-    size?: undefined;
-    url?: undefined;
-} | {
-    error: string;
-    repository: string;
-    suggestion: string;
-    content?: undefined;
-    path?: undefined;
-    sha?: undefined;
-    size?: undefined;
-    url?: undefined;
-} | {
-    content: string;
-    path: string;
-    repository: string;
-    sha: string;
-    size: number;
-    url: string;
-    error?: undefined;
-    suggestion?: undefined;
-}>;
-/**
- * List available example contracts and DApps
- */
-export declare function listExamples(input: ListExamplesInput): Promise<{
-    examples: {
-        name: string;
-        repository: string;
-        description: string;
-        complexity: "beginner" | "intermediate" | "advanced";
-        mainFile: string;
-        features: string[];
-        githubUrl: string;
-    }[];
-    totalCount: number;
-    categories: string[];
-}>;
-/**
- * Retrieve recent changes across Midnight repositories
- */
-export declare function getLatestUpdates(input: GetLatestUpdatesInput): Promise<{
-    summary: {
-        since: string;
-        totalCommits: number;
-        activeRepositories: number;
-        checkedRepositories: number;
-    };
-    updates: {
-        repository: string;
-        commitCount: number;
-        latestCommit: {
-            message: string;
-            date: string;
-            author: string;
-            url: string;
-        } | null;
-        recentCommits: {
-            message: string;
-            date: string;
-            sha: string;
-        }[];
-    }[];
-}>;
-/**
- * Get version and release info for a repository
- */
-export declare function getVersionInfo(input: GetVersionInfoInput): Promise<{
-    repository: string;
-    latestVersion: string;
-    latestStableVersion: string;
-    publishedAt: string | null;
-    releaseNotes: string | null;
-    recentReleases: {
-        version: string;
-        date: string;
-        isPrerelease: boolean;
-        url: string;
-    }[];
-    recentBreakingChanges: string[];
-    versionContext: string;
-}>;
-/**
- * Check for breaking changes since a specific version
- */
-export declare function checkBreakingChanges(input: CheckBreakingChangesInput): Promise<{
-    repository: string;
-    currentVersion: string;
-    latestVersion: string | null;
-    isOutdated: boolean;
-    versionsBehind: number;
-    hasBreakingChanges: boolean;
-    breakingChanges: string[];
-    recommendation: string;
-}>;
-/**
- * Get migration guide between versions
- */
-export declare function getMigrationGuide(input: GetMigrationGuideInput): Promise<{
-    repository: string;
-    from: string;
-    to: string;
-    summary: {
-        breakingChangesCount: number;
-        deprecationsCount: number;
-        newFeaturesCount: number;
-    };
-    breakingChanges: string[];
-    deprecations: string[];
-    newFeatures: string[];
-    migrationSteps: string[];
-    migrationDifficulty: string;
-}>;
-/**
- * Get a file at a specific version - critical for version-accurate recommendations
- */
-export declare function getFileAtVersion(input: GetFileAtVersionInput): Promise<{
-    repository: string;
-    path: string;
-    version: string;
-    content: string;
-    note: string;
-}>;
-/**
- * Compare syntax between two versions - shows what changed
- */
-export declare function compareSyntax(input: CompareSyntaxInput): Promise<{
-    repository: string;
-    path: string;
-    oldVersion: string;
-    newVersion: string;
-    hasDifferences: boolean;
-    oldContent: string | null;
-    newContent: string | null;
-    recommendation: string;
-}>;
-/**
- * Get the latest syntax reference for Compact language
- * This is the source of truth for writing valid, compilable contracts
- */
-export declare function getLatestSyntax(input: GetLatestSyntaxInput): Promise<{
-    repository: string;
-    version: string;
-    warning: string;
-    syntaxFiles: never[];
-    examplePaths: string[];
-    note?: undefined;
-} | {
-    repository: string;
-    version: string;
-    syntaxFiles: {
-        path: string;
-        content: string;
-    }[];
-    note: string;
-    warning?: undefined;
-    examplePaths?: undefined;
-}>;
-export declare const repositoryTools: ExtendedToolDefinition[];
+export * from "./repository/index.js";
 //# sourceMappingURL=repository.d.ts.map