user-majico-mcp 0.7.5

package/dist/project-selection.d.ts

@@ -0,0 +1,25 @@
+/** Project ambiguity hints for MCP ping / branding workflows. */
+import { type RankableProject, type RankedProject } from "./project-relevance.js";
+export declare const PROJECT_SELECTION_HINT = "Ask the user before branding tools: use an existing Majico project (pick from relevantProjects) or create a new one (create_project). Present each option with name and description; pass projectId on tool calls once confirmed.";
+export type ProjectSummary = RankableProject;
+export type ProjectSelectionFields = {
+    projectSelectionRequired: boolean;
+    relevantProjects: RankedProject[];
+    totalProjectCount: number;
+    hint?: string;
+    suggestedProjectId?: string;
+    suggestedProjectName?: string;
+    repoHints?: string[];
+};
+export { inferRepoNameHints, projectNameMatchesHints, findSuggestedProject, } from "./project-selection-hints.js";
+/**
+ * Surface ranked project options on ping when scope is not confirmed for this request.
+ */
+export declare function buildProjectSelectionFields(params: {
+    projects: ProjectSummary[];
+    activeProjectId: string;
+    activeProjectName: string;
+    explicitProjectId?: string;
+    consumerRepoPath?: string;
+    requestContext?: string;
+}): ProjectSelectionFields | null;

package/dist/project-selection.js

@@ -0,0 +1,42 @@
+/** Project ambiguity hints for MCP ping / branding workflows. */
+import { pickRelevantProjects, } from "./project-relevance.js";
+export const PROJECT_SELECTION_HINT = "Ask the user before branding tools: use an existing Majico project (pick from relevantProjects) or create a new one (create_project). Present each option with name and description; pass projectId on tool calls once confirmed.";
+export { inferRepoNameHints, projectNameMatchesHints, findSuggestedProject, } from "./project-selection-hints.js";
+import { inferRepoNameHints, projectNameMatchesHints, findSuggestedProject, } from "./project-selection-hints.js";
+/**
+ * Surface ranked project options on ping when scope is not confirmed for this request.
+ */
+export function buildProjectSelectionFields(params) {
+    const { projects, activeProjectId, activeProjectName, explicitProjectId, consumerRepoPath, requestContext, } = params;
+    const hasExplicitProjectId = Boolean(explicitProjectId?.trim());
+    const relevanceContext = {
+        consumerRepoPath,
+        requestContext,
+    };
+    const repoHints = inferRepoNameHints(consumerRepoPath);
+    const activeProject = projects.find((p) => p.id === activeProjectId);
+    const scopedProject = hasExplicitProjectId
+        ? projects.find((p) => p.id === explicitProjectId?.trim())
+        : activeProject;
+    const scopedName = scopedProject?.name ?? activeProjectName;
+    const scopedMatchesRepo = projectNameMatchesHints(scopedName, repoHints);
+    const suggested = findSuggestedProject(projects, repoHints);
+    const projectSelectionRequired = !hasExplicitProjectId || (repoHints.length > 0 && !scopedMatchesRepo);
+    if (!projectSelectionRequired)
+        return null;
+    const relevantProjects = pickRelevantProjects(projects, relevanceContext);
+    const fields = {
+        projectSelectionRequired,
+        relevantProjects,
+        totalProjectCount: projects.length,
+        hint: PROJECT_SELECTION_HINT,
+    };
+    if (repoHints.length > 0) {
+        fields.repoHints = repoHints;
+    }
+    if (suggested && suggested.id !== activeProjectId) {
+        fields.suggestedProjectId = suggested.id;
+        fields.suggestedProjectName = suggested.name;
+    }
+    return fields;
+}

package/dist/recommended-external-skills.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Researched external Cursor UI/UX skills — optional installs for consumer repos.
+ * Majico DB skills stay flexible; these are recommendations with install hints.
+ * Source: docs/internal/cursor-ui-ux-skills-research.md
+ */
+export type ExternalSkillKind = "ui" | "ux" | "workflow";
+export type RecommendedExternalSkill = {
+    id: string;
+    name: string;
+    kind: ExternalSkillKind;
+    author: string;
+    why: string;
+    whenToUse: string;
+    installCommand: string;
+    /** Cursor plugin slug if available without npx */
+    pluginRef?: string;
+    tier: 1 | 2;
+    stackHints?: string[];
+};
+/** Tier 1 — highest impact UI craft skills */
+export declare const KILLER_UI_SKILLS: readonly RecommendedExternalSkill[];
+/** Tier 1 — highest impact UX skills */
+export declare const KILLER_UX_SKILLS: readonly RecommendedExternalSkill[];
+export declare const WORKFLOW_SKILLS: readonly RecommendedExternalSkill[];
+export type RecommendedSkillsBundle = {
+    id: string;
+    label: string;
+    skills: string[];
+    note: string;
+};
+export declare const RECOMMENDED_SKILL_BUNDLES: readonly RecommendedSkillsBundle[];
+export declare function buildRecommendedExternalSkillsPayload(): {
+    killerUi: RecommendedExternalSkill[];
+    killerUx: RecommendedExternalSkill[];
+    workflow: RecommendedExternalSkill[];
+    bundles: RecommendedSkillsBundle[];
+    catalogUrl: string;
+    researchDoc: string;
+};

package/dist/recommended-external-skills.js

@@ -0,0 +1,319 @@
+/**
+ * Researched external Cursor UI/UX skills — optional installs for consumer repos.
+ * Majico DB skills stay flexible; these are recommendations with install hints.
+ * Source: docs/internal/cursor-ui-ux-skills-research.md
+ */
+/** Tier 1 — highest impact UI craft skills */
+export const KILLER_UI_SKILLS = [
+    {
+        id: "ui-skills-root",
+        name: "UI Skills Root",
+        kind: "ui",
+        author: "ibelick",
+        why: "Routes to the smallest useful skill set by topic and stack.",
+        whenToUse: "Start of any UI task — avoids loading the full 134-skill catalog.",
+        installCommand: "npx ui-skills add ui-skills-root",
+        tier: 1,
+    },
+    {
+        id: "baseline-ui",
+        name: "Baseline UI",
+        kind: "ui",
+        author: "ibelick",
+        why: "Fast deslop: spacing, hierarchy, typography, motion caps, a11y baseline.",
+        whenToUse: "After first UI draft; polish pass before ship.",
+        installCommand: "npx ui-skills add baseline-ui",
+        tier: 1,
+        stackHints: ["tailwind", "react"],
+    },
+    {
+        id: "make-interfaces-feel-better",
+        name: "Make Interfaces Feel Better",
+        kind: "ui",
+        author: "jakubkrehel",
+        why: "Micro-interactions, radii, hit areas, stagger — high craft ROI.",
+        whenToUse: "Buttons, cards, navigation, forms, modals.",
+        installCommand: "npx ui-skills add make-interfaces-feel-better",
+        tier: 1,
+    },
+    {
+        id: "fixing-accessibility",
+        name: "Fixing Accessibility",
+        kind: "ui",
+        author: "ibelick",
+        why: "Prioritized WCAG fixes: names, keyboard, focus, forms.",
+        whenToUse: "Interactive controls, dialogs, forms, audits.",
+        installCommand: "npx ui-skills add fixing-accessibility",
+        tier: 1,
+    },
+    {
+        id: "fixing-motion-performance",
+        name: "Fixing Motion Performance",
+        kind: "ui",
+        author: "ibelick",
+        why: "Compositor-safe motion; kills jank and layout-thrashing animations.",
+        whenToUse: "CSS/JS transitions, scroll-linked motion.",
+        installCommand: "npx ui-skills add fixing-motion-performance",
+        tier: 1,
+    },
+    {
+        id: "frontend-design",
+        name: "Frontend Design",
+        kind: "ui",
+        author: "anthropics",
+        why: "Distinctive marketing-grade UI that avoids generic AI aesthetics.",
+        whenToUse: "Landing/marketing when brand docs allow creative direction.",
+        installCommand: "npx ui-skills add frontend-design",
+        tier: 1,
+    },
+    {
+        id: "web-design-guidelines",
+        name: "Web Design Guidelines",
+        kind: "ui",
+        author: "vercel-labs",
+        why: "Audit UI against interface guidelines (a11y + UX patterns).",
+        whenToUse: "Pre-ship review of pages and components.",
+        installCommand: "npx skills add vercel-labs/agent-skills --skill web-design-guidelines",
+        tier: 1,
+        stackHints: ["react", "next"],
+    },
+    {
+        id: "12-principles-of-animation",
+        name: "12 Principles of Animation",
+        kind: "ui",
+        author: "raphaelsalaja",
+        why: "Disney animation principles applied to web — natural motion language.",
+        whenToUse: "Hero entrances, lists, modals, icon morphs.",
+        installCommand: "npx ui-skills add 12-principles-of-animation",
+        tier: 1,
+    },
+    {
+        id: "oklch-skill",
+        name: "OKLCH Color",
+        kind: "ui",
+        author: "jakubkrehel",
+        why: "Build accessible, tunable color systems in OKLCH.",
+        whenToUse: "Extending DESIGN.md tokens into full ramps.",
+        installCommand: "npx ui-skills add oklch-skill",
+        tier: 1,
+    },
+    {
+        id: "ui-design-brain",
+        name: "UI Design Brain",
+        kind: "ui",
+        author: "carmahhawwari",
+        why: "60+ component best practices, layouts, anti-patterns from component.gallery.",
+        whenToUse: "Greenfield components (tables, modals, nav, etc.).",
+        installCommand: "npx skills add carmahhawwari/ui-design-brain",
+        tier: 1,
+    },
+    {
+        id: "interface-design",
+        name: "Interface Design",
+        kind: "ui",
+        author: "Dammyjay93",
+        why: "Dashboard/admin/SaaS app patterns with craft focus.",
+        whenToUse: "App shell, settings, data-dense UI — not marketing landings.",
+        installCommand: "npx ui-skills add interface-design",
+        tier: 1,
+        stackHints: ["react"],
+    },
+    {
+        id: "ui-motion-expressive",
+        name: "UI Motion Expressive",
+        kind: "ui",
+        author: "majico",
+        why: "Per-brand motion from DESIGN.md §7 — intensity tiers, Motion One guidance, reduced-motion checklist.",
+        whenToUse: "Consumer repo handoff when user wants expressive motion; pair with sync_cursor_skills.",
+        installCommand: "Majico MCP: sync_cursor_skills (ships ui-motion-expressive from project DB)",
+        tier: 1,
+        stackHints: ["react", "next", "css"],
+    },
+    {
+        id: "shadcn",
+        name: "shadcn/ui",
+        kind: "ui",
+        author: "shadcn-ui",
+        why: "Project-aware shadcn compose, add, and fix patterns.",
+        whenToUse: "Repos already using shadcn/ui.",
+        installCommand: "npx ui-skills add shadcn",
+        tier: 1,
+        stackHints: ["react", "tailwind", "shadcn"],
+    },
+];
+/** Tier 1 — highest impact UX skills */
+export const KILLER_UX_SKILLS = [
+    {
+        id: "shape",
+        name: "Shape (UX brief)",
+        kind: "ux",
+        author: "pbakaus",
+        why: "Structured design interview → actionable brief before coding.",
+        whenToUse: "New feature or screen with unclear UX requirements.",
+        installCommand: "npx ui-skills add shape",
+        tier: 1,
+    },
+    {
+        id: "clarify",
+        name: "Clarify",
+        kind: "ux",
+        author: "pbakaus",
+        why: "Improves labels, microcopy, and action clarity.",
+        whenToUse: "Forms, onboarding, CTAs, empty states.",
+        installCommand: "npx ui-skills add clarify",
+        tier: 1,
+    },
+    {
+        id: "critique",
+        name: "Critique",
+        kind: "ux",
+        author: "pbakaus",
+        why: "Structured UX scoring with persona checks and fixes.",
+        whenToUse: "Review existing UI for UX quality.",
+        installCommand: "npx ui-skills add critique",
+        tier: 1,
+    },
+    {
+        id: "harden",
+        name: "Harden",
+        kind: "ux",
+        author: "pbakaus",
+        why: "Production UX: empty/error/edge cases, onboarding, i18n resilience.",
+        whenToUse: "Pre-launch hardening pass.",
+        installCommand: "npx ui-skills add harden",
+        tier: 1,
+    },
+    {
+        id: "distill",
+        name: "Distill",
+        kind: "ux",
+        author: "pbakaus",
+        why: "Simplify overloaded interfaces; restore focus.",
+        whenToUse: "Busy dashboards, settings, feature-creep screens.",
+        installCommand: "npx ui-skills add distill",
+        tier: 1,
+    },
+    {
+        id: "polish",
+        name: "Polish",
+        kind: "ux",
+        author: "pbakaus",
+        why: "Final alignment/spacing/consistency pass for launch readiness.",
+        whenToUse: "Last mile before ship (pairs with ui-craft-polish).",
+        installCommand: "npx ui-skills add polish",
+        tier: 1,
+    },
+    {
+        id: "interaction-design",
+        name: "Interaction Design",
+        kind: "ux",
+        author: "wshobson",
+        why: "Microinteractions, feedback, transitions for delightful flows.",
+        whenToUse: "Wizards, multi-step flows, async states.",
+        installCommand: "npx ui-skills add interaction-design",
+        tier: 1,
+    },
+    {
+        id: "uxauditor",
+        name: "UXAuditor",
+        kind: "ux",
+        author: "aihxp",
+        why: "End-to-end UX audit with scored uxaudit.md report.",
+        whenToUse: "Full product UX review; handoff to fix agents.",
+        installCommand: "npx skills add aihxp/uxauditor",
+        tier: 1,
+    },
+    {
+        id: "ux-expert",
+        name: "UX Expert",
+        kind: "ux",
+        author: "felixgeelhaar",
+        why: "Heuristics, IA, WCAG, dark patterns, agentic UI patterns.",
+        whenToUse: "Strategic UX questions and heuristic evaluation.",
+        installCommand: "npx skills add felixgeelhaar/skills --skill ux-expert",
+        tier: 1,
+    },
+    {
+        id: "wcag-audit-patterns",
+        name: "WCAG Audit Patterns",
+        kind: "ux",
+        author: "wshobson",
+        why: "WCAG 2.2 audit playbook with remediation strategies.",
+        whenToUse: "Compliance sprint or a11y lawsuit prep.",
+        installCommand: "npx ui-skills add wcag-audit-patterns",
+        tier: 1,
+    },
+];
+export const WORKFLOW_SKILLS = [
+    {
+        id: "brainstorming",
+        name: "Brainstorming",
+        kind: "workflow",
+        author: "obra/superpowers",
+        why: "Explore options before committing to layout or architecture.",
+        whenToUse: "Greenfield screens; user hasn't picked direction.",
+        installCommand: "npx skills add obra/superpowers --skill brainstorming",
+        pluginRef: "brainstorming",
+        tier: 2,
+    },
+    {
+        id: "verification-before-completion",
+        name: "Verification Before Completion",
+        kind: "workflow",
+        author: "obra/superpowers",
+        why: "Evidence before claiming UI work is done.",
+        whenToUse: "Before PR, commit, or ack_cursor_handoff.",
+        installCommand: "npx skills add obra/superpowers --skill verification-before-completion",
+        pluginRef: "verification-before-completion",
+        tier: 2,
+    },
+];
+export const RECOMMENDED_SKILL_BUNDLES = [
+    {
+        id: "marketing-landing",
+        label: "Marketing / landing",
+        skills: [
+            "ui-skills-root",
+            "baseline-ui",
+            "make-interfaces-feel-better",
+            "ui-motion-expressive",
+            "fixing-accessibility",
+            "clarify",
+            "polish",
+        ],
+        note: "Pair with Majico sync_cursor_skills + BRAND.md + DESIGN.md.",
+    },
+    {
+        id: "saas-app",
+        label: "SaaS app UI",
+        skills: [
+            "ui-skills-root",
+            "interface-design",
+            "harden",
+            "fixing-accessibility",
+            "web-design-guidelines",
+        ],
+        note: "Add react-best-practices for Next/React repos.",
+    },
+    {
+        id: "design-system",
+        label: "Design-system repo",
+        skills: [
+            "shadcn",
+            "oklch-skill",
+            "fixing-accessibility",
+            "wcag-audit-patterns",
+        ],
+        note: "Add team-authored component-usage + token-reference skills.",
+    },
+];
+export function buildRecommendedExternalSkillsPayload() {
+    return {
+        killerUi: [...KILLER_UI_SKILLS],
+        killerUx: [...KILLER_UX_SKILLS],
+        workflow: [...WORKFLOW_SKILLS],
+        bundles: [...RECOMMENDED_SKILL_BUNDLES],
+        catalogUrl: "https://www.ui-skills.com/skills/",
+        researchDoc: "docs/internal/cursor-ui-ux-skills-research.md",
+    };
+}

package/dist/sdk-surface.d.ts

@@ -0,0 +1,10 @@
+import type { MajicoClient } from "@majico/sdk";
+/**
+ * Resources required by user-majico-mcp tool dispatch.
+ * npm @majico/sdk@1.0.1 omitted these and caused staging
+ * "Cannot read properties of undefined" on ping / palette / blog.
+ */
+export declare const MCP_REQUIRED_SDK_RESOURCES: readonly ["projects", "palette", "blog", "pulse", "research", "cursorSkills"];
+export type McpRequiredSdkResource = (typeof MCP_REQUIRED_SDK_RESOURCES)[number];
+/** Returns an error message when the client is too old for this MCP server. */
+export declare function mcpSdkSurfaceError(client: Pick<MajicoClient, McpRequiredSdkResource> | Record<string, unknown>): string | null;

package/dist/sdk-surface.js

@@ -0,0 +1,24 @@
+/**
+ * Resources required by user-majico-mcp tool dispatch.
+ * npm @majico/sdk@1.0.1 omitted these and caused staging
+ * "Cannot read properties of undefined" on ping / palette / blog.
+ */
+export const MCP_REQUIRED_SDK_RESOURCES = [
+    "projects",
+    "palette",
+    "blog",
+    "pulse",
+    "research",
+    "cursorSkills",
+];
+/** Returns an error message when the client is too old for this MCP server. */
+export function mcpSdkSurfaceError(client) {
+    for (const key of MCP_REQUIRED_SDK_RESOURCES) {
+        if (!(key in client) || client[key] == null) {
+            return ("Incompatible @majico/sdk: need >= 1.1.0 with projects, palette, blog, " +
+                "pulse, research, and cursorSkills. Published 1.0.1 is too old for " +
+                "user-majico-mcp >= 0.6.0.");
+        }
+    }
+    return null;
+}

package/dist/server-branding.d.ts

@@ -0,0 +1,17 @@
+/** MCP serverInfo branding (icons, title) for Cursor and other MCP clients. */
+export declare const MAJICO_MCP_SERVER_TITLE = "Majico";
+export declare const MAJICO_MCP_SERVER_DESCRIPTION = "Brand guidelines, design tokens, and studio canvas for Majico projects.";
+export declare const MAJICO_MCP_WEBSITE_URL = "https://majico.xyz";
+export declare const MAJICO_MCP_ICON_SVG_PATH = "/brand/mcp-icon.svg";
+export declare const MAJICO_MCP_ICON_PNG_PATH = "/brand/mcp-icon-96.png";
+export type McpServerIcon = {
+    src: string;
+    mimeType: string;
+    sizes?: string[];
+    theme?: "light" | "dark";
+};
+/**
+ * Build absolute HTTPS icon URLs for MCP `serverInfo.icons`.
+ * Falls back to production when no public base is available (stdio).
+ */
+export declare function buildMcpServerIcons(publicBaseUrl?: string, iconBaseUrl?: string): McpServerIcon[];

package/dist/server-branding.js

@@ -0,0 +1,40 @@
+/** MCP serverInfo branding (icons, title) for Cursor and other MCP clients. */
+export const MAJICO_MCP_SERVER_TITLE = "Majico";
+export const MAJICO_MCP_SERVER_DESCRIPTION = "Brand guidelines, design tokens, and studio canvas for Majico projects.";
+export const MAJICO_MCP_WEBSITE_URL = "https://majico.xyz";
+export const MAJICO_MCP_ICON_SVG_PATH = "/brand/mcp-icon.svg";
+export const MAJICO_MCP_ICON_PNG_PATH = "/brand/mcp-icon-96.png";
+/**
+ * Build absolute HTTPS icon URLs for MCP `serverInfo.icons`.
+ * Falls back to production when no public base is available (stdio).
+ */
+export function buildMcpServerIcons(publicBaseUrl, iconBaseUrl) {
+    const base = normalizePublicBaseUrl(iconBaseUrl ?? publicBaseUrl);
+    return [
+        {
+            src: `${base}${MAJICO_MCP_ICON_SVG_PATH}`,
+            mimeType: "image/svg+xml",
+            sizes: ["any"],
+        },
+        {
+            src: `${base}${MAJICO_MCP_ICON_PNG_PATH}`,
+            mimeType: "image/png",
+            sizes: ["96x96"],
+        },
+    ];
+}
+function normalizePublicBaseUrl(publicBaseUrl) {
+    const trimmed = publicBaseUrl?.trim().replace(/\/$/, "");
+    if (trimmed) {
+        try {
+            const url = new URL(trimmed);
+            if (url.protocol === "http:" || url.protocol === "https:") {
+                return url.origin;
+            }
+        }
+        catch {
+            /* fall through */
+        }
+    }
+    return "https://majico.xyz";
+}

package/dist/server.d.ts

@@ -0,0 +1,3 @@
+import { Server } from "@modelcontextprotocol/sdk/server";
+import type { CredentialSource } from "./credentials.js";
+export declare function createMajicoMcpServer(defaultCredentials?: CredentialSource): Server;

package/dist/server.js

@@ -0,0 +1,24 @@
+import { Server } from "@modelcontextprotocol/sdk/server";
+import { CallToolRequestSchema, ListToolsRequestSchema, } from "@modelcontextprotocol/sdk/types.js";
+import { buildMcpServerIcons, MAJICO_MCP_SERVER_DESCRIPTION, MAJICO_MCP_SERVER_TITLE, MAJICO_MCP_WEBSITE_URL, } from "./server-branding.js";
+import { handleMajicoToolCall, listMcpTools, MCP_SERVER_VERSION, } from "./tools.js";
+export function createMajicoMcpServer(defaultCredentials) {
+    const server = new Server({
+        name: "user-majico",
+        title: MAJICO_MCP_SERVER_TITLE,
+        version: MCP_SERVER_VERSION,
+        description: MAJICO_MCP_SERVER_DESCRIPTION,
+        websiteUrl: MAJICO_MCP_WEBSITE_URL,
+        icons: buildMcpServerIcons(defaultCredentials?.publicBaseUrl, defaultCredentials?.iconBaseUrl),
+    }, { capabilities: { tools: {} } });
+    server.setRequestHandler(ListToolsRequestSchema, async () => ({
+        tools: listMcpTools({
+            includeAdminTools: Boolean(defaultCredentials?.includeAdminTools),
+        }),
+    }));
+    server.setRequestHandler(CallToolRequestSchema, async (request) => {
+        const { name, arguments: args } = request.params;
+        return handleMajicoToolCall(name, (args ?? {}), defaultCredentials);
+    });
+    return server;
+}

package/dist/svg-preview-block.d.ts

@@ -0,0 +1,14 @@
+import type { McpContentBlock } from "./present-types.js";
+/**
+ * Ink currentColor and ensure sharp has a root xmlns + explicit size.
+ * Avoids wrapping in a second SVG (librsvg + Turbopack `">` corruption).
+ */
+export declare function prepareSvgMarkupForRaster(svg: string): string;
+/** @deprecated Use prepareSvgMarkupForRaster — kept for call-site compatibility. */
+export declare function prepareSvgForChatPreview(svg: string): string;
+/**
+ * Rasterize inline SVG to a PNG MCP image block (Cursor renders PNG, not SVG).
+ * Pads on a light canvas via sharp.composite (no wrapper SVG string).
+ * Soft-fails to a text note when sharp cannot rasterize.
+ */
+export declare function svgPreviewBlock(svg: string): Promise<McpContentBlock>;

package/dist/svg-preview-block.js

@@ -0,0 +1,82 @@
+import sharp from "sharp";
+const PREVIEW_PAD = 24;
+const PREVIEW_MARK_SIZE = 96;
+const PREVIEW_BG = { r: 0xf4, g: 0xf4, b: 0xf5, alpha: 1 };
+const PREVIEW_FG = "#111111";
+const IMAGE_ANNOTATIONS = {
+    audience: ["user", "assistant"],
+    priority: 0.9,
+};
+/** Runtime `>` so Turbopack/SWC cannot strip `">` from folded template literals. */
+function gt() {
+    return String.fromCharCode(0x3e);
+}
+/**
+ * Ink currentColor and ensure sharp has a root xmlns + explicit size.
+ * Avoids wrapping in a second SVG (librsvg + Turbopack `">` corruption).
+ */
+export function prepareSvgMarkupForRaster(svg) {
+    let markup = svg
+        .trim()
+        .replace(/\bcurrentColor\b/gi, PREVIEW_FG)
+        .replace(/\bcurrentcolour\b/gi, PREVIEW_FG);
+    // Repair truncated viewBox smashed into the next tag (Turbopack artifact).
+    markup = markup.replace(/(viewBox\s*=\s*["'][^"']*?)\s*(<[a-zA-Z/])/g, (_, vb, next) => `${vb}"${gt()}${next}`);
+    if (!/\sxmlns=/i.test(markup)) {
+        markup = markup.replace(/<svg\b/i, `<svg xmlns="http://www.w3.org/2000/svg"`);
+    }
+    if (!/\swidth=/i.test(markup)) {
+        const close = gt();
+        markup = markup.replace(/<svg\b([^>]*)>/i, (_m, attrs) => [
+            `<svg${attrs} width="${PREVIEW_MARK_SIZE}" height="${PREVIEW_MARK_SIZE}"`,
+            close,
+        ].join(""));
+    }
+    return markup;
+}
+/** @deprecated Use prepareSvgMarkupForRaster — kept for call-site compatibility. */
+export function prepareSvgForChatPreview(svg) {
+    return prepareSvgMarkupForRaster(svg);
+}
+/**
+ * Rasterize inline SVG to a PNG MCP image block (Cursor renders PNG, not SVG).
+ * Pads on a light canvas via sharp.composite (no wrapper SVG string).
+ * Soft-fails to a text note when sharp cannot rasterize.
+ */
+export async function svgPreviewBlock(svg) {
+    try {
+        const markup = prepareSvgMarkupForRaster(svg);
+        const markPng = await sharp(Buffer.from(markup, "utf8"))
+            .resize(PREVIEW_MARK_SIZE, PREVIEW_MARK_SIZE, {
+            fit: "contain",
+            background: { r: 0, g: 0, b: 0, alpha: 0 },
+        })
+            .png()
+            .toBuffer();
+        const size = PREVIEW_MARK_SIZE + PREVIEW_PAD * 2;
+        const png = await sharp({
+            create: {
+                width: size,
+                height: size,
+                channels: 4,
+                background: PREVIEW_BG,
+            },
+        })
+            .composite([{ input: markPng, left: PREVIEW_PAD, top: PREVIEW_PAD }])
+            .png()
+            .toBuffer();
+        return {
+            type: "image",
+            data: png.toString("base64"),
+            mimeType: "image/png",
+            annotations: IMAGE_ANNOTATIONS,
+        };
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        return {
+            type: "text",
+            text: `_(PNG preview unavailable: ${message})_`,
+        };
+    }
+}