@decantr/mcp-server 1.0.0-beta.3 → 1.0.0-beta.4

package/dist/index.js

@@ -10,13 +10,12 @@ import {
 
 // src/tools.ts
 import { readFile } from "fs/promises";
-import { join as join2 } from "path";
+import { join } from "path";
 import { validateEssence, evaluateGuard } from "@decantr/essence-spec";
-import { createRegistryClient, resolvePatternPreset } from "@decantr/registry";
+import { resolvePatternPreset } from "@decantr/registry";
 
 // src/helpers.ts
-import { createResolver } from "@decantr/registry";
-import { join } from "path";
+import { RegistryAPIClient } from "@decantr/registry";
 var MAX_INPUT_LENGTH = 1e3;
 function validateStringArg(args, field) {
   const val = args[field];
@@ -28,18 +27,15 @@ function validateStringArg(args, field) {
   }
   return null;
 }
-var _resolver = null;
-function getResolver() {
-  if (!_resolver) {
-    const envRoot = process.env.DECANTR_CONTENT_ROOT;
-    const bundledRoot = join(import.meta.dirname, "..", "..", "..", "content");
-    const npmRoot = join(process.cwd(), "node_modules", "@decantr", "content");
-    _resolver = createResolver({
-      contentRoot: envRoot || bundledRoot,
-      overridePaths: envRoot ? [] : [npmRoot]
+var _apiClient = null;
+function getAPIClient() {
+  if (!_apiClient) {
+    _apiClient = new RegistryAPIClient({
+      baseUrl: process.env.DECANTR_API_URL || void 0,
+      apiKey: process.env.DECANTR_API_KEY || void 0
     });
   }
-  return _resolver;
+  return _apiClient;
 }
 
 // src/tools.ts
@@ -96,7 +92,8 @@ var TOOLS = [
       type: "object",
       properties: {
         id: { type: "string", description: 'Pattern ID (e.g. "hero", "data-table", "kpi-grid")' },
-        preset: { type: "string", description: 'Optional preset name (e.g. "product", "content")' }
+        preset: { type: "string", description: 'Optional preset name (e.g. "product", "content")' },
+        namespace: { type: "string", description: 'Namespace (default: "@official")' }
       },
       required: ["id"]
     },
@@ -109,7 +106,8 @@ var TOOLS = [
     inputSchema: {
       type: "object",
       properties: {
-        id: { type: "string", description: 'Archetype ID (e.g. "saas-dashboard", "ecommerce")' }
+        id: { type: "string", description: 'Archetype ID (e.g. "saas-dashboard", "ecommerce")' },
+        namespace: { type: "string", description: 'Namespace (default: "@official")' }
       },
       required: ["id"]
     },
@@ -122,7 +120,8 @@ var TOOLS = [
     inputSchema: {
       type: "object",
       properties: {
-        id: { type: "string", description: 'Recipe ID (e.g. "auradecantism")' }
+        id: { type: "string", description: 'Recipe ID (e.g. "auradecantism")' },
+        namespace: { type: "string", description: 'Namespace (default: "@official")' }
       },
       required: ["id"]
     },
@@ -135,7 +134,8 @@ var TOOLS = [
     inputSchema: {
       type: "object",
       properties: {
-        id: { type: "string", description: 'Blueprint ID (e.g. "saas-dashboard", "ecommerce", "portfolio")' }
+        id: { type: "string", description: 'Blueprint ID (e.g. "saas-dashboard", "ecommerce", "portfolio")' },
+        namespace: { type: "string", description: 'Namespace (default: "@official")' }
       },
       required: ["id"]
     },
@@ -189,9 +189,10 @@ var TOOLS = [
   }
 ];
 async function handleTool(name, args) {
+  const apiClient = getAPIClient();
   switch (name) {
     case "decantr_read_essence": {
-      const essencePath = args.path || join2(process.cwd(), "decantr.essence.json");
+      const essencePath = args.path || join(process.cwd(), "decantr.essence.json");
       try {
         const raw = await readFile(essencePath, "utf-8");
         return JSON.parse(raw);
@@ -200,7 +201,7 @@ async function handleTool(name, args) {
       }
     }
     case "decantr_validate": {
-      const essencePath = args.path || join2(process.cwd(), "decantr.essence.json");
+      const essencePath = args.path || join(process.cwd(), "decantr.essence.json");
       let essence;
       try {
         essence = JSON.parse(await readFile(essencePath, "utf-8"));
@@ -221,16 +222,19 @@ async function handleTool(name, args) {
       const err = validateStringArg(args, "query");
       if (err) return { error: err };
       try {
-        const client = createRegistryClient();
-        const results = await client.search(args.query, args.type);
+        const response = await apiClient.search({
+          q: args.query,
+          type: args.type
+        });
         return {
-          total: results.length,
-          results: results.map((r) => ({
+          total: response.total,
+          results: response.results.map((r) => ({
             type: r.type,
-            id: r.id,
+            id: r.slug,
+            namespace: r.namespace,
             name: r.name,
             description: r.description,
-            install: `decantr registry add ${r.type}/${r.id}`
+            install: `decantr get ${r.type} ${r.slug}`
           }))
         };
       } catch (e) {
@@ -240,116 +244,112 @@ async function handleTool(name, args) {
     case "decantr_resolve_pattern": {
       const err = validateStringArg(args, "id");
       if (err) return { error: err };
-      const resolver = getResolver();
-      const resolved = await resolver.resolve("pattern", args.id);
-      if (!resolved) {
-        return { found: false, message: `Pattern "${args.id}" not found.` };
-      }
-      const result = { found: true, ...resolved.item };
-      if (args.preset && typeof args.preset === "string") {
-        const preset = resolvePatternPreset(resolved.item, args.preset);
-        if (preset) result.resolvedPreset = preset;
+      const namespace = args.namespace || "@official";
+      try {
+        const pattern = await apiClient.getPattern(namespace, args.id);
+        const result = { found: true, ...pattern };
+        if (args.preset && typeof args.preset === "string") {
+          const preset = resolvePatternPreset(pattern, args.preset);
+          if (preset) result.resolvedPreset = preset;
+        }
+        return result;
+      } catch {
+        return { found: false, message: `Pattern "${args.id}" not found in ${namespace}.` };
       }
-      return result;
     }
     case "decantr_resolve_archetype": {
       const err = validateStringArg(args, "id");
       if (err) return { error: err };
-      const resolver = getResolver();
-      const resolved = await resolver.resolve("archetype", args.id);
-      if (!resolved) {
-        return { found: false, message: `Archetype "${args.id}" not found.` };
+      const namespace = args.namespace || "@official";
+      try {
+        const archetype = await apiClient.getArchetype(namespace, args.id);
+        return { found: true, ...archetype };
+      } catch {
+        return { found: false, message: `Archetype "${args.id}" not found in ${namespace}.` };
       }
-      return { found: true, ...resolved.item };
     }
     case "decantr_resolve_recipe": {
       const err = validateStringArg(args, "id");
       if (err) return { error: err };
-      const resolver = getResolver();
-      const resolved = await resolver.resolve("recipe", args.id);
-      if (!resolved) {
-        return { found: false, message: `Recipe "${args.id}" not found.` };
+      const namespace = args.namespace || "@official";
+      try {
+        const recipe = await apiClient.getRecipe(namespace, args.id);
+        return { found: true, ...recipe };
+      } catch {
+        return { found: false, message: `Recipe "${args.id}" not found in ${namespace}.` };
       }
-      return { found: true, ...resolved.item };
     }
     case "decantr_resolve_blueprint": {
       const err = validateStringArg(args, "id");
       if (err) return { error: err };
-      const resolver = getResolver();
-      const resolved = await resolver.resolve("blueprint", args.id);
-      if (!resolved) {
-        return { found: false, message: `Blueprint "${args.id}" not found.` };
+      const namespace = args.namespace || "@official";
+      try {
+        const blueprint = await apiClient.getBlueprint(namespace, args.id);
+        return { found: true, ...blueprint };
+      } catch {
+        return { found: false, message: `Blueprint "${args.id}" not found in ${namespace}.` };
       }
-      return { found: true, ...resolved.item };
     }
     case "decantr_suggest_patterns": {
       const err = validateStringArg(args, "description");
       if (err) return { error: err };
       const desc = args.description.toLowerCase();
-      const resolver = getResolver();
-      const patternIds = [
-        "hero",
-        "kpi-grid",
-        "data-table",
-        "card-grid",
-        "chart-grid",
-        "filter-bar",
-        "form-sections",
-        "detail-header",
-        "activity-feed",
-        "cta-section"
-      ];
-      const suggestions = [];
-      for (const id of patternIds) {
-        const resolved = await resolver.resolve("pattern", id);
-        if (!resolved) continue;
-        const p = resolved.item;
-        const searchable = [
-          p.name || "",
-          p.description || "",
-          ...p.components || [],
-          ...p.tags || []
-        ].join(" ").toLowerCase();
-        let score = 0;
-        const words = desc.split(/\s+/);
-        for (const word of words) {
-          if (word.length < 3) continue;
-          if (searchable.includes(word)) score += 10;
-        }
-        if (desc.includes("dashboard") && ["kpi-grid", "chart-grid", "data-table", "filter-bar"].includes(id)) score += 20;
-        if (desc.includes("metric") && id === "kpi-grid") score += 15;
-        if (desc.includes("chart") && id === "chart-grid") score += 15;
-        if (desc.includes("table") && id === "data-table") score += 15;
-        if (desc.includes("form") && id === "form-sections") score += 15;
-        if (desc.includes("setting") && id === "form-sections") score += 15;
-        if (desc.includes("landing") && ["hero", "cta-section", "card-grid"].includes(id)) score += 20;
-        if (desc.includes("hero") && id === "hero") score += 20;
-        if (desc.includes("ecommerce") && ["card-grid", "filter-bar", "detail-header"].includes(id)) score += 15;
-        if (desc.includes("product") && id === "card-grid") score += 15;
-        if (desc.includes("feed") && id === "activity-feed") score += 15;
-        if (desc.includes("filter") && id === "filter-bar") score += 15;
-        if (desc.includes("search") && id === "filter-bar") score += 10;
-        if (score > 0) {
-          const preset = p.presets && typeof p.presets === "object" ? Object.values(p.presets)[0] : null;
-          suggestions.push({
-            id,
-            score,
-            name: p.name || id,
-            description: p.description || "",
-            components: p.components || [],
-            layout: preset?.layout ? preset.layout.layout || "grid" : "grid"
-          });
+      try {
+        const patternsResponse = await apiClient.listContent("patterns", {
+          namespace: "@official",
+          limit: 100
+        });
+        const suggestions = [];
+        for (const p of patternsResponse.items) {
+          const searchable = [
+            p.name || "",
+            p.description || "",
+            ...p.components || [],
+            ...p.tags || []
+          ].join(" ").toLowerCase();
+          let score = 0;
+          const words = desc.split(/\s+/);
+          for (const word of words) {
+            if (word.length < 3) continue;
+            if (searchable.includes(word)) score += 10;
+          }
+          if (desc.includes("dashboard") && ["kpi-grid", "chart-grid", "data-table", "filter-bar"].includes(p.id)) score += 20;
+          if (desc.includes("metric") && p.id === "kpi-grid") score += 15;
+          if (desc.includes("chart") && p.id === "chart-grid") score += 15;
+          if (desc.includes("table") && p.id === "data-table") score += 15;
+          if (desc.includes("form") && p.id === "form-sections") score += 15;
+          if (desc.includes("setting") && p.id === "form-sections") score += 15;
+          if (desc.includes("landing") && ["hero", "cta-section", "card-grid"].includes(p.id)) score += 20;
+          if (desc.includes("hero") && p.id === "hero") score += 20;
+          if (desc.includes("ecommerce") && ["card-grid", "filter-bar", "detail-header"].includes(p.id)) score += 15;
+          if (desc.includes("product") && p.id === "card-grid") score += 15;
+          if (desc.includes("feed") && p.id === "activity-feed") score += 15;
+          if (desc.includes("filter") && p.id === "filter-bar") score += 15;
+          if (desc.includes("search") && p.id === "filter-bar") score += 10;
+          if (score > 0) {
+            const preset = p.presets ? Object.values(p.presets)[0] : null;
+            suggestions.push({
+              id: p.id,
+              score,
+              name: p.name || p.id,
+              description: p.description || "",
+              components: p.components || [],
+              layout: preset?.layout ? preset.layout.layout : "grid"
+            });
+          }
         }
+        suggestions.sort((a, b) => b.score - a.score);
+        return {
+          query: args.description,
+          suggestions: suggestions.slice(0, 5),
+          total: suggestions.length
+        };
+      } catch (e) {
+        return { error: `Could not fetch patterns: ${e.message}` };
       }
-      suggestions.sort((a, b) => b.score - a.score);
-      return {
-        query: args.description,
-        suggestions: suggestions.slice(0, 5),
-        total: suggestions.length
-      };
     }
     case "decantr_check_drift": {
-      const essencePath = args.path || join2(process.cwd(), "decantr.essence.json");
+      const essencePath = args.path || join(process.cwd(), "decantr.essence.json");
       let essence;
       try {
         essence = JSON.parse(await readFile(essencePath, "utf-8"));
@@ -417,7 +417,6 @@ async function handleTool(name, args) {
         "ecommerce-admin",
         "workbench"
       ];
-      const resolver = getResolver();
       for (const id of archetypeIds) {
         let score = 0;
         if (desc.includes("dashboard") && id.includes("dashboard")) score += 20;
@@ -437,9 +436,14 @@ async function handleTool(name, args) {
       }
       archetypeScores.sort((a, b) => b.score - a.score);
       const bestMatch = archetypeScores[0]?.id || "saas-dashboard";
-      const archetypeResult = await resolver.resolve("archetype", bestMatch);
-      const archetype = archetypeResult?.item;
-      const pages = archetype?.pages;
+      let pages;
+      let features = [];
+      try {
+        const archetype = await apiClient.getArchetype("@official", bestMatch);
+        pages = archetype.pages;
+        features = archetype.features || [];
+      } catch {
+      }
       const structure = (pages || [{ id: "home", shell: "full-bleed", default_layout: ["hero"] }]).map((p) => ({
         id: p.id,
         shell: p.shell || "sidebar-main",
@@ -457,7 +461,7 @@ async function handleTool(name, args) {
         personality: ["professional"],
         platform: { type: "spa", routing: "hash" },
         structure,
-        features: archetype?.features || [],
+        features,
         guard: { enforce_style: true, enforce_recipe: true, mode: "strict" },
         density: { level: "comfortable", content_gap: "_gap4" },
         target: framework,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@decantr/mcp-server",
-  "version": "1.0.0-beta.3",
+  "version": "1.0.0-beta.4",
   "description": "MCP server for Decantr — exposes design intelligence tools to AI coding assistants",
   "license": "MIT",
   "repository": {
@@ -15,20 +15,18 @@
   },
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
-  "files": [
-    "dist"
-  ],
+  "files": ["dist"],
   "publishConfig": {
     "access": "public"
   },
-  "dependencies": {
-    "@modelcontextprotocol/sdk": "^1.0.0",
-    "@decantr/essence-spec": "1.0.0-beta.3",
-    "@decantr/registry": "1.0.0-beta.3"
-  },
   "scripts": {
     "build": "tsup",
     "test": "vitest run",
     "test:watch": "vitest"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.0",
+    "@decantr/essence-spec": "workspace:*",
+    "@decantr/registry": "workspace:*"
   }
-}
+}

package/LICENSE

@@ -1,21 +0,0 @@
-MIT License
-
-Copyright (c) 2026 Decantr AI
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.