@uidbai/mcp-server 0.2.0 → 0.3.1

package/dist/tools/guide.js

@@ -0,0 +1,304 @@
+/**
+ * UIDB MCP Tool: uidb_guide
+ *
+ * Unified component guidance tool. Replaces the multi-step ask_intent/ask_question/finalize flow.
+ * Reads local .uidb/ files and optionally calls UIDB API for LLM-powered recommendations.
+ */
+import { readComponent, readPattern, getDesignSystemSummary, UIDBNotFoundError, } from "../core/local-fs.js";
+import { apiClient } from "../core/api-client.js";
+export const guideTool = {
+    name: "uidb_guide",
+    description: `Get component guidance for building UI.
+
+Analyzes your request against the local design system (.uidb/) and returns:
+- Recommended components with props and examples
+- Matching patterns if available
+- Theme configuration to use
+- Design guidelines to follow
+
+This is the primary tool for UI development. Use before building any UI component.
+
+Example:
+  uidb_guide({ description: "user profile card with avatar and status badge" })`,
+    inputSchema: {
+        type: "object",
+        properties: {
+            description: {
+                type: "string",
+                description: "Describe the UI you want to build",
+            },
+            context: {
+                type: "object",
+                properties: {
+                    file: {
+                        type: "string",
+                        description: "Current file being edited",
+                    },
+                    existing_components: {
+                        type: "array",
+                        items: { type: "string" },
+                        description: "Components already imported in the file",
+                    },
+                },
+                description: "Optional context about the current file",
+            },
+            use_llm: {
+                type: "boolean",
+                description: "Use UIDB API for enhanced LLM guidance (default: true)",
+                default: true,
+            },
+        },
+        required: ["description"],
+    },
+    async execute(args) {
+        try {
+            // Get design system context
+            const summary = await getDesignSystemSummary();
+            // Try LLM guidance first if enabled
+            if (args.use_llm !== false) {
+                try {
+                    const llmResult = await getLLMGuidance(args.description, summary, args.context);
+                    return {
+                        content: [
+                            {
+                                type: "text",
+                                text: JSON.stringify(llmResult, null, 2),
+                            },
+                        ],
+                    };
+                }
+                catch (llmError) {
+                    // Fall back to local guidance if API fails
+                    console.error("LLM guidance failed, falling back to local:", llmError);
+                }
+            }
+            // Local guidance (rule-based matching)
+            const result = await getLocalGuidance(args.description, summary);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify(result, null, 2),
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            if (error instanceof UIDBNotFoundError) {
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: JSON.stringify({
+                                error: "NOT_INITIALIZED",
+                                message: "No .uidb folder found. Run uidb_init first.",
+                            }, null, 2),
+                        },
+                    ],
+                    isError: true,
+                };
+            }
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify({
+                            error: "GUIDE_FAILED",
+                            message: error instanceof Error
+                                ? error.message
+                                : "Failed to get guidance",
+                        }, null, 2),
+                    },
+                ],
+                isError: true,
+            };
+        }
+    },
+};
+/**
+ * Get guidance from UIDB API (LLM-powered)
+ */
+async function getLLMGuidance(description, summary, context) {
+    const response = await apiClient.post("/api/guide", {
+        description,
+        design_system: {
+            components: summary.components.map((c) => ({
+                id: c.id,
+                name: c.name,
+                category: c.category,
+            })),
+            patterns: summary.patterns.map((p) => ({
+                id: p.id,
+                name: p.name,
+                category: p.category,
+            })),
+            config: summary.config.theme,
+        },
+        context,
+    });
+    return response.guidance;
+}
+/**
+ * Get guidance using local rule-based matching
+ */
+async function getLocalGuidance(description, summary) {
+    const descLower = description.toLowerCase();
+    // Find matching components based on keywords
+    const matchedComponents = [];
+    for (const component of summary.components) {
+        let score = 0;
+        // Check if component name or id is mentioned
+        if (descLower.includes(component.id.toLowerCase()))
+            score += 10;
+        if (descLower.includes(component.name.toLowerCase()))
+            score += 10;
+        // Check category keywords
+        const categoryKeywords = {
+            interaction: ["button", "click", "action", "submit", "cancel"],
+            form: ["input", "field", "form", "text", "select", "checkbox", "switch", "toggle"],
+            layout: ["card", "container", "section", "box", "grid", "flex"],
+            navigation: ["menu", "nav", "tab", "link", "dropdown"],
+            overlay: ["modal", "dialog", "popup", "popover", "tooltip"],
+            feedback: ["alert", "message", "notification", "callout", "toast"],
+            "data-display": ["badge", "avatar", "status", "label", "tag"],
+        };
+        const keywords = categoryKeywords[component.category] || [];
+        for (const keyword of keywords) {
+            if (descLower.includes(keyword))
+                score += 5;
+        }
+        if (score > 0) {
+            matchedComponents.push({ entry: component, score });
+        }
+    }
+    // Sort by score and take top matches
+    matchedComponents.sort((a, b) => b.score - a.score);
+    const topComponents = matchedComponents.slice(0, 5);
+    // Load full details for matched components
+    const recommendedComponents = await Promise.all(topComponents.map(async ({ entry }) => {
+        try {
+            const details = await readComponent(entry.id);
+            return {
+                id: entry.id,
+                name: entry.name,
+                reason: `Matches your request for ${entry.category} functionality`,
+                props_to_use: getRecommendedProps(details, descLower),
+                example: details.examples
+                    ? Object.values(details.examples)[0] || ""
+                    : "",
+            };
+        }
+        catch {
+            return {
+                id: entry.id,
+                name: entry.name,
+                reason: `Matches your request`,
+                props_to_use: {},
+                example: "",
+            };
+        }
+    }));
+    // Find matching patterns
+    const matchedPatterns = [];
+    for (const pattern of summary.patterns) {
+        let score = 0;
+        if (descLower.includes(pattern.id.toLowerCase()))
+            score += 10;
+        if (descLower.includes(pattern.name.toLowerCase()))
+            score += 10;
+        // Check description keywords
+        const patternKeywords = pattern.description.toLowerCase().split(" ");
+        for (const keyword of patternKeywords) {
+            if (keyword.length > 3 && descLower.includes(keyword))
+                score += 2;
+        }
+        if (score > 0) {
+            matchedPatterns.push({ entry: pattern, score });
+        }
+    }
+    matchedPatterns.sort((a, b) => b.score - a.score);
+    const topPatterns = matchedPatterns.slice(0, 3);
+    // Load pattern details
+    const recommendedPatterns = await Promise.all(topPatterns.map(async ({ entry }) => {
+        try {
+            const details = await readPattern(entry.id);
+            const firstVariant = Object.entries(details.variants)[0];
+            return {
+                id: entry.id,
+                name: entry.name,
+                reason: `Matches your UI pattern requirement`,
+                variant: firstVariant?.[0] || "default",
+                code: firstVariant?.[1]?.code || "",
+            };
+        }
+        catch {
+            return {
+                id: entry.id,
+                name: entry.name,
+                reason: `Matches your pattern`,
+                variant: "default",
+                code: "",
+            };
+        }
+    }));
+    // Build guidelines based on components
+    const guidelines = [
+        `Use accent color "${summary.config.theme.accentColor}" for primary actions`,
+        `Use gray color "gray" for secondary/cancel actions`,
+        `Apply radius "${summary.config.theme.radius}" via Radix Theme`,
+    ];
+    if (descLower.includes("form") || descLower.includes("input")) {
+        guidelines.push("Always use visible labels for form inputs");
+        guidelines.push("Provide clear error messages for validation");
+    }
+    if (descLower.includes("button") || descLower.includes("action")) {
+        guidelines.push("Use solid variant for primary actions, soft for secondary");
+        guidelines.push("Icon-only buttons require aria-label");
+    }
+    if (descLower.includes("dialog") || descLower.includes("modal")) {
+        guidelines.push("Always include Dialog.Title for accessibility");
+        guidelines.push("Place cancel button left of primary action");
+    }
+    return {
+        recommended_components: recommendedComponents,
+        recommended_patterns: recommendedPatterns,
+        theme: {
+            accentColor: summary.config.theme.accentColor,
+            grayColor: summary.config.theme.grayColor,
+            radius: summary.config.theme.radius,
+        },
+        guidelines,
+    };
+}
+/**
+ * Get recommended props based on description keywords
+ */
+function getRecommendedProps(component, description) {
+    const props = {};
+    // Check semantic intents
+    if (component.semantic_intents) {
+        for (const [intent, config] of Object.entries(component.semantic_intents)) {
+            const intentConfig = config;
+            if (intentConfig.use_for) {
+                for (const useCase of intentConfig.use_for) {
+                    if (description.includes(useCase.toLowerCase())) {
+                        if (intentConfig.color)
+                            props.color = intentConfig.color;
+                        if (intentConfig.variant)
+                            props.variant = intentConfig.variant;
+                        break;
+                    }
+                }
+            }
+        }
+    }
+    // Check for size keywords
+    if (description.includes("small") || description.includes("compact")) {
+        props.size = "1";
+    }
+    else if (description.includes("large") || description.includes("hero")) {
+        props.size = "4";
+    }
+    return props;
+}
+//# sourceMappingURL=guide.js.map

package/dist/tools/guide.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"guide.js","sourceRoot":"","sources":["../../src/tools/guide.ts"],"names":[],"mappings":"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"}

package/dist/tools/index.d.ts

@@ -2,17 +2,16 @@
  * UIDB MCP Server - Tools Module
  *
  * Re-exports tool registry and all tools.
+ * Tools operate on the local .uidb folder (embedded design system).
  */
 export * from "./registry.js";
-export { askIntentTool } from "./ask-intent.js";
-export { askQuestionTool } from "./ask-question.js";
-export { finalizeTool } from "./finalize.js";
+export { initTool } from "./init.js";
+export { guideTool } from "./guide.js";
 export { listComponentsTool } from "./list-components.js";
+export { listPatternsTool } from "./list-patterns.js";
 export { detectPatternTool } from "./detect-pattern.js";
 export { submitPatternTool } from "./submit-pattern.js";
-export { listPatternsTool } from "./list-patterns.js";
 export { getConfigTool } from "./get-config.js";
 export { updateConfigTool } from "./update-config.js";
-export { loginTool } from "./login.js";
 export { statusTool } from "./status.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/tools/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,eAAe,CAAC;AAG9B,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAC7C,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AACvC,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,cAAc,eAAe,CAAC;AAG9B,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AACrC,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AACvC,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC"}

package/dist/tools/index.js

@@ -2,18 +2,17 @@
  * UIDB MCP Server - Tools Module
  *
  * Re-exports tool registry and all tools.
+ * Tools operate on the local .uidb folder (embedded design system).
  */
 export * from "./registry.js";
 // Individual tool exports for direct access if needed
-export { askIntentTool } from "./ask-intent.js";
-export { askQuestionTool } from "./ask-question.js";
-export { finalizeTool } from "./finalize.js";
+export { initTool } from "./init.js";
+export { guideTool } from "./guide.js";
 export { listComponentsTool } from "./list-components.js";
+export { listPatternsTool } from "./list-patterns.js";
 export { detectPatternTool } from "./detect-pattern.js";
 export { submitPatternTool } from "./submit-pattern.js";
-export { listPatternsTool } from "./list-patterns.js";
 export { getConfigTool } from "./get-config.js";
 export { updateConfigTool } from "./update-config.js";
-export { loginTool } from "./login.js";
 export { statusTool } from "./status.js";
 //# sourceMappingURL=index.js.map

package/dist/tools/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,eAAe,CAAC;AAE9B,sDAAsD;AACtD,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAC7C,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AACvC,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,cAAc,eAAe,CAAC;AAE9B,sDAAsD;AACtD,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AACrC,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AACvC,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC"}

package/dist/tools/init.d.ts

@@ -0,0 +1,73 @@
+/**
+ * UIDB MCP Tool: uidb_init
+ *
+ * Initialize a new .uidb design system folder in the current project.
+ */
+import { TemplateType } from "../templates/index.js";
+interface InitInput {
+    project_name: string;
+    template?: TemplateType;
+    accent_color?: string;
+    gray_color?: string;
+    radius?: string;
+    appearance?: "light" | "dark";
+}
+export declare const initTool: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            project_name: {
+                type: string;
+                description: string;
+            };
+            template: {
+                type: string;
+                enum: string[];
+                description: string;
+                default: string;
+            };
+            accent_color: {
+                type: string;
+                enum: readonly ["gray", "gold", "bronze", "brown", "yellow", "amber", "orange", "tomato", "red", "ruby", "crimson", "pink", "plum", "purple", "violet", "iris", "indigo", "blue", "cyan", "teal", "jade", "green", "grass", "lime", "mint", "sky"];
+                description: string;
+                default: string;
+            };
+            gray_color: {
+                type: string;
+                enum: readonly ["gray", "mauve", "slate", "sage", "olive", "sand"];
+                description: string;
+                default: string;
+            };
+            radius: {
+                type: string;
+                enum: readonly ["none", "small", "medium", "large", "full"];
+                description: string;
+                default: string;
+            };
+            appearance: {
+                type: string;
+                enum: string[];
+                description: string;
+                default: string;
+            };
+        };
+        required: string[];
+    };
+    execute(args: InitInput): Promise<{
+        content: {
+            type: "text";
+            text: string;
+        }[];
+        isError: boolean;
+    } | {
+        content: {
+            type: "text";
+            text: string;
+        }[];
+        isError?: undefined;
+    }>;
+};
+export {};
+//# sourceMappingURL=init.d.ts.map

package/dist/tools/init.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../src/tools/init.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAe,YAAY,EAAkB,MAAM,uBAAuB,CAAC;AASlF,UAAU,SAAS;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,YAAY,CAAC;IACxB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC;CAC/B;AAED,eAAO,MAAM,QAAQ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBA0DC,SAAS;;;;;;;;;;;;;CAwK9B,CAAC"}

package/dist/tools/init.js

@@ -0,0 +1,211 @@
+/**
+ * UIDB MCP Tool: uidb_init
+ *
+ * Initialize a new .uidb design system folder in the current project.
+ */
+import { uidbExists, initUIDB } from "../core/local-fs.js";
+import { getTemplate } from "../templates/index.js";
+import { VALID_ACCENT_COLORS, VALID_GRAY_COLORS, VALID_RADIUS_VALUES, } from "../core/types.js";
+import { loadCredentials } from "../core/auth.js";
+import { apiClient } from "../core/api-client.js";
+export const initTool = {
+    name: "uidb_init",
+    description: `Initialize a new UIDB design system in the current project.
+
+Creates a .uidb/ folder with:
+- manifest.json: Project metadata
+- config.json: Theme configuration (accent color, radius, etc.)
+- components/: Component definitions
+- patterns/: Reusable UI patterns
+- rules/: Accessibility and design constraints
+
+Templates:
+- "minimal": Just config and empty indices (build your own)
+- "standard": Full set of Radix UI components and common patterns (recommended)
+
+After initialization, use uidb_guide for component guidance.`,
+    inputSchema: {
+        type: "object",
+        properties: {
+            project_name: {
+                type: "string",
+                description: "Name of the project (e.g., 'My App')",
+            },
+            template: {
+                type: "string",
+                enum: ["minimal", "standard"],
+                description: "Template to use. 'standard' is recommended for most projects.",
+                default: "standard",
+            },
+            accent_color: {
+                type: "string",
+                enum: VALID_ACCENT_COLORS,
+                description: "Primary accent color for the theme",
+                default: "blue",
+            },
+            gray_color: {
+                type: "string",
+                enum: VALID_GRAY_COLORS,
+                description: "Gray color palette for neutral elements",
+                default: "slate",
+            },
+            radius: {
+                type: "string",
+                enum: VALID_RADIUS_VALUES,
+                description: "Border radius scale for components",
+                default: "medium",
+            },
+            appearance: {
+                type: "string",
+                enum: ["light", "dark"],
+                description: "Default color scheme",
+                default: "light",
+            },
+        },
+        required: ["project_name"],
+    },
+    async execute(args) {
+        try {
+            // Check if .uidb already exists
+            if (await uidbExists()) {
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: JSON.stringify({
+                                error: "ALREADY_EXISTS",
+                                message: "A .uidb folder already exists in this project. Use uidb_get_config to view the current configuration.",
+                            }, null, 2),
+                        },
+                    ],
+                    isError: true,
+                };
+            }
+            // Try to fetch project config from portal if authenticated
+            let config;
+            let projectName = args.project_name;
+            let fetchedFromPortal = false;
+            try {
+                const credentials = await loadCredentials();
+                if (credentials) {
+                    // Fetch project config from portal
+                    const projectData = await apiClient.get(`/api/projects/${credentials.projectId}`);
+                    if (projectData?.config) {
+                        config = {
+                            accentColor: projectData.config.accentColor || "blue",
+                            grayColor: projectData.config.grayColor || "slate",
+                            radius: projectData.config.radius || "medium",
+                            appearance: projectData.config.appearance || "light",
+                        };
+                        projectName = projectData.name || args.project_name;
+                        fetchedFromPortal = true;
+                        // Register connection with portal by updating onboarding step
+                        try {
+                            await apiClient.put(`/api/projects/${credentials.projectSlug}/onboarding-step`, {
+                                step: "connected",
+                            });
+                        }
+                        catch (connError) {
+                            // Connection registration failed but continue
+                            console.error("Failed to register connection:", connError);
+                        }
+                    }
+                    else {
+                        // No config from portal, use arguments or defaults
+                        config = {
+                            accentColor: args.accent_color || "blue",
+                            grayColor: args.gray_color || "slate",
+                            radius: args.radius || "medium",
+                            appearance: args.appearance || "light",
+                        };
+                    }
+                }
+                else {
+                    // Not authenticated, use arguments or defaults
+                    config = {
+                        accentColor: args.accent_color || "blue",
+                        grayColor: args.gray_color || "slate",
+                        radius: args.radius || "medium",
+                        appearance: args.appearance || "light",
+                    };
+                }
+            }
+            catch (authError) {
+                // Auth/API failed, use arguments or defaults
+                config = {
+                    accentColor: args.accent_color || "blue",
+                    grayColor: args.gray_color || "slate",
+                    radius: args.radius || "medium",
+                    appearance: args.appearance || "light",
+                };
+            }
+            // Get template
+            const templateType = args.template || "standard";
+            const template = getTemplate(templateType, config, projectName);
+            // Initialize .uidb folder
+            const projectRoot = process.cwd();
+            await initUIDB(projectRoot, template.files);
+            // Build success response
+            const componentCount = templateType === "standard"
+                ? Object.keys(template.files).filter((f) => f.startsWith("components/") && f !== "components/_index.json").length
+                : 0;
+            const patternCount = templateType === "standard"
+                ? Object.keys(template.files).filter((f) => f.startsWith("patterns/") && f !== "patterns/_index.json").length
+                : 0;
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify({
+                            success: true,
+                            message: `UIDB design system initialized for "${projectName}"`,
+                            source: fetchedFromPortal ? "portal" : "manual",
+                            template: templateType,
+                            config: {
+                                accentColor: config.accentColor,
+                                grayColor: config.grayColor,
+                                radius: config.radius,
+                                appearance: config.appearance,
+                            },
+                            created: {
+                                components: componentCount,
+                                patterns: patternCount,
+                            },
+                            ready: true,
+                            next_steps: fetchedFromPortal
+                                ? [
+                                    "✅ Connected to UIDB portal",
+                                    "✅ Design system configured with your project theme",
+                                    "✅ You're all set! Start building UI components.",
+                                    "",
+                                    "Use 'uidb_guide' when you need component guidance",
+                                ]
+                                : [
+                                    "Import config in your root layout: import config from '../.uidb/config.json'",
+                                    "Pass theme values to Radix Theme component",
+                                    "Use uidb_guide when building UI components",
+                                ],
+                        }, null, 2),
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify({
+                            error: "INIT_FAILED",
+                            message: error instanceof Error
+                                ? error.message
+                                : "Failed to initialize UIDB",
+                        }, null, 2),
+                    },
+                ],
+                isError: true,
+            };
+        }
+    },
+};
+//# sourceMappingURL=init.js.map