@mandujs/mcp 0.38.12 → 0.39.0-beta.1

package/src/tools/runtime.ts

@@ -11,7 +11,7 @@ import {
   loadManifest,
   needsHydration,
 } from "@mandujs/core";
-import type { BundleManifest } from "@mandujs/core/bundler";
+import type { BundleManifest } from "@mandujs/core/compat/bundler/index";
 import { getDevServerState } from "./project.js";
 import { readRuntimeControl } from "../utils/runtime-control.js";
 import path from "path";

package/src/tools/seo.ts

@@ -18,7 +18,7 @@ import {
   type Sitemap,
   type RobotsFile,
   type JsonLd,
-} from "@mandujs/core";
+} from "@mandujs/core/compat/seo/index";
 import { getProjectPaths } from "../utils/project.js";
 import * as fs from "fs";
 import * as path from "path";

package/src/tools/slot-validation.ts

@@ -1,13 +1,13 @@
-import type { Tool } from "@modelcontextprotocol/sdk/types.js";
-import {
-  DEFAULT_SLOT_CONSTRAINTS,
-  API_SLOT_CONSTRAINTS,
-  READONLY_SLOT_CONSTRAINTS,
-} from "@mandujs/core";
-
-export const slotValidationToolDefinitions: Tool[] = [
-  {
-    name: "mandu.slot.constraints",
+import type { Tool } from "@modelcontextprotocol/sdk/types.js";
+import {
+  DEFAULT_SLOT_CONSTRAINTS,
+  API_SLOT_CONSTRAINTS,
+  READONLY_SLOT_CONSTRAINTS,
+} from "@mandujs/core";
+
+export const slotValidationToolDefinitions: Tool[] = [
+  {
+    name: "mandu.slot.constraints",
     description:
       "Get recommended slot constraint presets (default, api, readonly).",
     annotations: {
@@ -27,10 +27,10 @@ export const slotValidationToolDefinitions: Tool[] = [
   },
 ];
 
-export function slotValidationTools(projectRoot: string) {
-  void projectRoot;
-  const handlers: Record<string, (args: Record<string, unknown>) => Promise<unknown>> = {
-    "mandu.slot.constraints": async (args: Record<string, unknown>) => {
+export function slotValidationTools(projectRoot: string) {
+  void projectRoot;
+  const handlers: Record<string, (args: Record<string, unknown>) => Promise<unknown>> = {
+    "mandu.slot.constraints": async (args: Record<string, unknown>) => {
       const { preset } = args as { preset?: "default" | "api" | "readonly" };
 
       const presets = {
@@ -84,10 +84,10 @@ Mandu.filling()
         `.trim(),
       };
     },
-  };
-
-  // Backward-compatible aliases
-  handlers["mandu_get_slot_constraints"] = handlers["mandu.slot.constraints"];
-
+  };
+
+  // Backward-compatible aliases
+  handlers["mandu_get_slot_constraints"] = handlers["mandu.slot.constraints"];
+
   return handlers;
 }

package/src/tools/spec.ts

@@ -1,11 +1,11 @@
 import type { Tool } from "@modelcontextprotocol/sdk/types.js";
-import {
-  loadManifest,
-  generateManifest,
-} from "@mandujs/core";
-import { getProjectPaths, isInsideProject, readJsonFile } from "../utils/project.js";
-import path from "path";
-import fs from "fs/promises";
+import {
+  loadManifest,
+  generateManifest,
+} from "@mandujs/core";
+import { getProjectPaths, isInsideProject, readJsonFile } from "../utils/project.js";
+import path from "path";
+import fs from "fs/promises";
 
 export const specToolDefinitions: Tool[] = [
   {
@@ -21,8 +21,8 @@ export const specToolDefinitions: Tool[] = [
       required: [],
     },
   },
-  {
-    name: "mandu.route.get",
+  {
+    name: "mandu.route.get",
     description:
       "Get full details of a specific route by its ID. Use before modifying a route.",
     annotations: {
@@ -37,32 +37,32 @@ export const specToolDefinitions: Tool[] = [
         },
       },
       required: ["routeId"],
-    },
-  },
-  {
-    name: "mandu.route.boundaries",
-    description:
-      "Inspect compiler-discovered client boundary metadata for one route or all routes, including route manifest records and optional bundle manifest entries.",
-    annotations: {
-      readOnlyHint: true,
-    },
-    inputSchema: {
-      type: "object",
-      properties: {
-        routeId: {
-          type: "string",
-          description: "Optional route ID to inspect. Omit to list boundaries for all routes.",
-        },
-        includeBundle: {
-          type: "boolean",
-          description: "When true, also correlate route boundaries with .mandu/manifest.json boundary bundle entries.",
-        },
-      },
-      required: [],
-    },
-  },
-  {
-    name: "mandu.route.add",
+    },
+  },
+  {
+    name: "mandu.route.boundaries",
+    description:
+      "Inspect compiler-discovered client boundary metadata for one route or all routes, including route manifest records and optional bundle manifest entries.",
+    annotations: {
+      readOnlyHint: true,
+    },
+    inputSchema: {
+      type: "object",
+      properties: {
+        routeId: {
+          type: "string",
+          description: "Optional route ID to inspect. Omit to list boundaries for all routes.",
+        },
+        includeBundle: {
+          type: "boolean",
+          description: "When true, also correlate route boundaries with .mandu/manifest.json boundary bundle entries.",
+        },
+      },
+      required: [],
+    },
+  },
+  {
+    name: "mandu.route.add",
     description:
       "Scaffold a new route in app/ with optional slot and contract files, then regenerate the manifest.",
     annotations: {
@@ -151,7 +151,7 @@ export function specTools(projectRoot: string) {
       };
     },
 
-    "mandu.route.get": async (args: Record<string, unknown>) => {
+    "mandu.route.get": async (args: Record<string, unknown>) => {
       const { routeId } = args as { routeId: string };
 
       const result = await loadManifest(paths.manifestPath);
@@ -164,158 +164,158 @@ export function specTools(projectRoot: string) {
         return { error: `Route not found: ${routeId}` };
       }
 
-      return { route };
-    },
-
-    "mandu.route.boundaries": async (args: Record<string, unknown>) => {
-      const { routeId, includeBundle = false } = args as { routeId?: string; includeBundle?: boolean };
-
-      const result = await loadManifest(paths.manifestPath);
-      if (!result.success || !result.data) {
-        return { error: result.errors };
-      }
-
-      const bundleManifestPath = path.join(projectRoot, ".mandu", "manifest.json");
-      const bundleManifest = includeBundle
-        ? await readJsonFile<{
-            boundaries?: Record<string, {
-              route?: string;
-              js?: string;
-              module?: string;
-              exportName?: string;
-              priority?: string;
-              hydrate?: string;
-            }>;
-          }>(bundleManifestPath)
-        : null;
-
-      const routes = routeId
-        ? result.data.routes.filter((route) => route.id === routeId)
-        : result.data.routes;
-
-      if (routeId && routes.length === 0) {
-        return { error: `Route not found: ${routeId}` };
-      }
-
-      const inspected = routes.map((route) => {
-        const boundaries = route.boundaries ?? [];
-        const diagnostics: Array<{
-          code: string;
-          severity: "warning";
-          message: string;
-          routeId: string;
-          boundaryId?: string;
-        }> = [];
-
-        if (includeBundle && boundaries.length > 0 && !bundleManifest) {
-          diagnostics.push({
-            code: "MANDU_BOUNDARY_BUNDLE_MANIFEST_MISSING",
-            severity: "warning",
-            message: "Route has compiler-discovered client boundaries, but .mandu/manifest.json was not found. Run mandu build to inspect generated boundary chunks.",
-            routeId: route.id,
-          });
-        }
-
-        const boundaryRecords = boundaries.map((boundary) => {
-          const bundle = bundleManifest?.boundaries?.[boundary.id];
-          if (includeBundle && bundleManifest && !bundle) {
-            diagnostics.push({
-              code: "MANDU_BOUNDARY_BUNDLE_ENTRY_MISSING",
-              severity: "warning",
-              message: `Boundary '${boundary.id}' is present in routes manifest but missing from .mandu/manifest.json boundaries.`,
-              routeId: route.id,
-              boundaryId: boundary.id,
-            });
-          }
-
-          return {
-            id: boundary.id,
-            routeId: boundary.routeId,
-            module: boundary.module,
-            importSpecifier: boundary.importSpecifier,
-            exportName: boundary.exportName,
-            localName: boundary.localName,
-            hydrate: boundary.hydrate,
-            ordinal: boundary.ordinal,
-            propsSource: boundary.propsSource,
-            propsKeys: boundary.propsKeys ?? [],
-            hasSpreadProps: !!boundary.hasSpreadProps,
-            source: boundary.source,
-            bundle: bundle
-              ? {
-                  js: bundle.js ?? null,
-                  priority: bundle.priority ?? null,
-                  hydrate: bundle.hydrate ?? null,
-                }
-              : null,
-          };
-        });
-
-        return {
-          routeId: route.id,
-          pattern: route.pattern,
-          module: route.module,
-          boundaryCount: boundaryRecords.length,
-          boundaries: boundaryRecords,
-          diagnostics,
-        };
-      });
-
-      return {
-        source: {
-          routesManifest: ".mandu/routes.manifest.json",
-          bundleManifest: includeBundle && bundleManifest ? ".mandu/manifest.json" : null,
-        },
-        includeBundle,
-        routeId: routeId ?? null,
-        routeCount: inspected.length,
-        boundaryCount: inspected.reduce((count, route) => count + route.boundaryCount, 0),
-        routes: inspected,
-      };
-    },
-
-    "mandu.route.add": async (args: Record<string, unknown>) => {
+      return { route };
+    },
+
+    "mandu.route.boundaries": async (args: Record<string, unknown>) => {
+      const { routeId, includeBundle = false } = args as { routeId?: string; includeBundle?: boolean };
+
+      const result = await loadManifest(paths.manifestPath);
+      if (!result.success || !result.data) {
+        return { error: result.errors };
+      }
+
+      const bundleManifestPath = path.join(projectRoot, ".mandu", "manifest.json");
+      const bundleManifest = includeBundle
+        ? await readJsonFile<{
+            boundaries?: Record<string, {
+              route?: string;
+              js?: string;
+              module?: string;
+              exportName?: string;
+              priority?: string;
+              hydrate?: string;
+            }>;
+          }>(bundleManifestPath)
+        : null;
+
+      const routes = routeId
+        ? result.data.routes.filter((route) => route.id === routeId)
+        : result.data.routes;
+
+      if (routeId && routes.length === 0) {
+        return { error: `Route not found: ${routeId}` };
+      }
+
+      const inspected = routes.map((route) => {
+        const boundaries = route.boundaries ?? [];
+        const diagnostics: Array<{
+          code: string;
+          severity: "warning";
+          message: string;
+          routeId: string;
+          boundaryId?: string;
+        }> = [];
+
+        if (includeBundle && boundaries.length > 0 && !bundleManifest) {
+          diagnostics.push({
+            code: "MANDU_BOUNDARY_BUNDLE_MANIFEST_MISSING",
+            severity: "warning",
+            message: "Route has compiler-discovered client boundaries, but .mandu/manifest.json was not found. Run mandu build to inspect generated boundary chunks.",
+            routeId: route.id,
+          });
+        }
+
+        const boundaryRecords = boundaries.map((boundary) => {
+          const bundle = bundleManifest?.boundaries?.[boundary.id];
+          if (includeBundle && bundleManifest && !bundle) {
+            diagnostics.push({
+              code: "MANDU_BOUNDARY_BUNDLE_ENTRY_MISSING",
+              severity: "warning",
+              message: `Boundary '${boundary.id}' is present in routes manifest but missing from .mandu/manifest.json boundaries.`,
+              routeId: route.id,
+              boundaryId: boundary.id,
+            });
+          }
+
+          return {
+            id: boundary.id,
+            routeId: boundary.routeId,
+            module: boundary.module,
+            importSpecifier: boundary.importSpecifier,
+            exportName: boundary.exportName,
+            localName: boundary.localName,
+            hydrate: boundary.hydrate,
+            ordinal: boundary.ordinal,
+            propsSource: boundary.propsSource,
+            propsKeys: boundary.propsKeys ?? [],
+            hasSpreadProps: !!boundary.hasSpreadProps,
+            source: boundary.source,
+            bundle: bundle
+              ? {
+                  js: bundle.js ?? null,
+                  priority: bundle.priority ?? null,
+                  hydrate: bundle.hydrate ?? null,
+                }
+              : null,
+          };
+        });
+
+        return {
+          routeId: route.id,
+          pattern: route.pattern,
+          module: route.module,
+          boundaryCount: boundaryRecords.length,
+          boundaries: boundaryRecords,
+          diagnostics,
+        };
+      });
+
+      return {
+        source: {
+          routesManifest: ".mandu/routes.manifest.json",
+          bundleManifest: includeBundle && bundleManifest ? ".mandu/manifest.json" : null,
+        },
+        includeBundle,
+        routeId: routeId ?? null,
+        routeCount: inspected.length,
+        boundaryCount: inspected.reduce((count, route) => count + route.boundaryCount, 0),
+        routes: inspected,
+      };
+    },
+
+    "mandu.route.add": async (args: Record<string, unknown>) => {
       const { path: routePath, kind, withSlot = true, withContract = false } = args as {
         path: string;
         kind: "api" | "page";
         withSlot?: boolean;
         withContract?: boolean;
-      };
-
-      const createdFiles: string[] = [];
-      const normalizedRoutePath = normalizeRoutePath(routePath);
-      if (!normalizedRoutePath) {
-        return {
-          error: "Route path must be a non-empty relative path inside app/",
-        };
-      }
-
-      // Scaffold app/ file
-      const fileName = kind === "api" ? "route.ts" : "page.tsx";
-      const appFilePath = path.resolve(paths.appDir, normalizedRoutePath, fileName);
-      if (!isInsideProject(appFilePath, paths.appDir)) {
-        return {
-          error: "Route path resolves outside app/",
-        };
-      }
-      if (await Bun.file(appFilePath).exists()) {
-        return {
-          error: `Route source already exists: app/${normalizedRoutePath}/${fileName}`,
-        };
-      }
-      const appFileDir = path.dirname(appFilePath);
-
-      await fs.mkdir(appFileDir, { recursive: true });
+      };
+
+      const createdFiles: string[] = [];
+      const normalizedRoutePath = normalizeRoutePath(routePath);
+      if (!normalizedRoutePath) {
+        return {
+          error: "Route path must be a non-empty relative path inside app/",
+        };
+      }
+
+      // Scaffold app/ file
+      const fileName = kind === "api" ? "route.ts" : "page.tsx";
+      const appFilePath = path.resolve(paths.appDir, normalizedRoutePath, fileName);
+      if (!isInsideProject(appFilePath, paths.appDir)) {
+        return {
+          error: "Route path resolves outside app/",
+        };
+      }
+      if (await Bun.file(appFilePath).exists()) {
+        return {
+          error: `Route source already exists: app/${normalizedRoutePath}/${fileName}`,
+        };
+      }
+      const appFileDir = path.dirname(appFilePath);
+
+      await fs.mkdir(appFileDir, { recursive: true });
 
       if (kind === "api") {
         await Bun.write(appFilePath, `export function GET(req: Request) {\n  return Response.json({ message: "Hello" });\n}\n`);
-      } else {
-        await Bun.write(appFilePath, `export default function Page() {\n  return <div>Page</div>;\n}\n`);
-      }
-      createdFiles.push(`app/${normalizedRoutePath}/${fileName}`);
-
-      // Derive route ID from path
-      const routeId = normalizedRoutePath.replace(/\//g, "-").replace(/[\[\]\.]/g, "");
+      } else {
+        await Bun.write(appFilePath, `export default function Page() {\n  return <div>Page</div>;\n}\n`);
+      }
+      createdFiles.push(`app/${normalizedRoutePath}/${fileName}`);
+
+      // Derive route ID from path
+      const routeId = normalizedRoutePath.replace(/\//g, "-").replace(/[\[\]\.]/g, "");
 
       // Scaffold slot if requested
       if (withSlot) {
@@ -405,27 +405,27 @@ export function specTools(projectRoot: string) {
   };
 
   // Backward-compatible aliases (deprecated)
-  handlers["mandu_list_routes"] = handlers["mandu.route.list"];
-  handlers["mandu_get_route"] = handlers["mandu.route.get"];
+  handlers["mandu_list_routes"] = handlers["mandu.route.list"];
+  handlers["mandu_get_route"] = handlers["mandu.route.get"];
   handlers["mandu_add_route"] = handlers["mandu.route.add"];
   handlers["mandu_delete_route"] = handlers["mandu.route.delete"];
   handlers["mandu_validate_manifest"] = handlers["mandu.manifest.validate"];
-
-  return handlers;
-}
-
-function normalizeRoutePath(value: unknown): string | null {
-  if (typeof value !== "string") return null;
-  const trimmed = value.trim().replace(/\\/g, "/");
-  const withoutAppPrefix = trimmed.replace(/^app\//, "");
-  const normalized = withoutAppPrefix.replace(/^\/+|\/+$/g, "");
-  if (!normalized) return null;
-
-  const segments = normalized.split("/").filter(Boolean);
-  if (segments.length === 0) return null;
-  if (segments.some((segment) => segment === "." || segment === ".." || segment.includes(":") || segment.includes("\0"))) {
-    return null;
-  }
-
-  return segments.join("/");
-}
+
+  return handlers;
+}
+
+function normalizeRoutePath(value: unknown): string | null {
+  if (typeof value !== "string") return null;
+  const trimmed = value.trim().replace(/\\/g, "/");
+  const withoutAppPrefix = trimmed.replace(/^app\//, "");
+  const normalized = withoutAppPrefix.replace(/^\/+|\/+$/g, "");
+  if (!normalized) return null;
+
+  const segments = normalized.split("/").filter(Boolean);
+  if (segments.length === 0) return null;
+  if (segments.some((segment) => segment === "." || segment === ".." || segment.includes(":") || segment.includes("\0"))) {
+    return null;
+  }
+
+  return segments.join("/");
+}

package/src/tools/transaction.ts

@@ -5,7 +5,7 @@ import {
   rollbackChange,
   getTransactionStatus,
   hasActiveTransaction,
-} from "@mandujs/core/change";
+} from "@mandujs/core/compat/change/index";
 import { acquireLock, releaseLock, checkLock, requireLock } from "../tx-lock.js";
 
 export const transactionToolDefinitions: Tool[] = [