@primer/mcp 0.5.1 → 1.0.0-rc.3fb350b1f

package/dist/{server-Dv5XFnmA.js → server-CBy5I-Dh.js}

@@ -1,5 +1,5 @@
 import { createRequire } from "node:module";
-import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { McpServer, inputRequired, inputResponse } from "@modelcontextprotocol/server";
 import * as cheerio from "cheerio";
 import * as z from "zod";
 import TurndownService from "turndown";
@@ -395,10 +395,12 @@ function loadAllTokensWithGuidelines() {
 	}
 }
 function loadDesignTokensGuide() {
-	return readFileSync(createRequire(import.meta.url).resolve("@primer/primitives/DESIGN_TOKENS_GUIDE.md"), "utf-8");
+	const guidePath = createRequire(import.meta.url).resolve("@primer/primitives/DESIGN_TOKENS_GUIDE.md");
+	return readFileSync(guidePath, "utf-8");
 }
 function loadDesignTokensSpec() {
-	return readFileSync(createRequire(import.meta.url).resolve("@primer/primitives/DESIGN_TOKENS_SPEC.md"), "utf-8");
+	const specPath = createRequire(import.meta.url).resolve("@primer/primitives/DESIGN_TOKENS_SPEC.md");
+	return readFileSync(specPath, "utf-8");
 }
 function getDesignTokenSpecsText(groups) {
 	return `
@@ -689,27 +691,31 @@ function runStylelint(css) {
 	});
 }
 //#endregion
+//#region package.json
+var version = "1.0.0";
+//#endregion
 //#region src/server.ts
-const server = new McpServer({
-	name: "Primer",
-	version: "0.5.1"
-});
 const turndownService = new TurndownService();
 const allTokensWithGuidelines = loadAllTokensWithGuidelines();
-server.registerTool("init", {
-	description: "Setup or create a project that includes Primer React",
-	annotations: { readOnlyHint: true }
-}, async () => {
-	const url = new URL(`/product/getting-started/react`, "https://primer.style");
-	const response = await fetch(url);
-	if (!response.ok) throw new Error(`Failed to fetch ${url}: ${response.statusText}`);
-	const html = await response.text();
-	if (!html) return { content: [] };
-	const source = cheerio.load(html)("main").html();
-	if (!source) return { content: [] };
-	return { content: [{
-		type: "text",
-		text: `The getting started documentation for Primer React is included below. It's important that the project:
+function createServer() {
+	const server = new McpServer({
+		name: "Primer",
+		version
+	});
+	server.registerTool("init", {
+		description: "Setup or create a project that includes Primer React",
+		annotations: { readOnlyHint: true }
+	}, async () => {
+		const url = new URL(`/product/getting-started/react`, "https://primer.style");
+		const response = await fetch(url);
+		if (!response.ok) throw new Error(`Failed to fetch ${url}: ${response.statusText}`);
+		const html = await response.text();
+		if (!html) return { content: [] };
+		const source = cheerio.load(html)("main").html();
+		if (!source) return { content: [] };
+		return { content: [{
+			type: "text",
+			text: `The getting started documentation for Primer React is included below. It's important that the project:
 
 - Is using a tool like Vite, Next.js, etc that supports TypeScript and React. If the project does not have support for that, generate an appropriate project scaffold
 - Installs the latest version of \`@primer/react\` from \`npm\`
@@ -722,187 +728,187 @@ server.registerTool("init", {
 
 ${turndownService.turndown(source)}
 `
-	}] };
-});
-server.registerTool("list_components", {
-	description: "List all of the components available from Primer React",
-	annotations: { readOnlyHint: true }
-}, async () => {
-	return { content: [{
-		type: "text",
-		text: `The following components are available in the @primer/react in TypeScript projects:
+		}] };
+	});
+	server.registerTool("list_components", {
+		description: "List all of the components available from Primer React",
+		annotations: { readOnlyHint: true }
+	}, async () => {
+		return { content: [{
+			type: "text",
+			text: `The following components are available in the @primer/react in TypeScript projects:
 
 ${listComponents().map((component) => {
-			return `- ${component.name}`;
-		}).join("\n")}
+				return `- ${component.name}`;
+			}).join("\n")}
 
 Use \`get_component\` for exactly one component and \`get_component_batch\` for 2 to 10 components. You can use these components from the @primer/react package.`
-	}] };
-});
-server.registerTool("get_component", {
-	description: "Retrieve official documentation and usage details for exactly one React component from the @primer/react package. Use get_component_batch for 2 to 10 components.",
-	inputSchema: { name: z.string().describe("The name of the component to retrieve") },
-	annotations: { readOnlyHint: true }
-}, async ({ name }) => {
-	const match = listComponents().find((component) => {
-		return component.name === name || component.name.toLowerCase() === name.toLowerCase();
-	});
-	if (!match) return {
-		isError: true,
-		errorMessage: `There is no component named \`${name}\` in the @primer/react package. For a full list of components, use the \`list_components\` tool.`,
-		content: []
-	};
-	try {
-		const llmsUrl = new URL(`/product/components/${match.slug}/llms.txt`, "https://primer.style");
-		const llmsResponse = await fetch(llmsUrl);
-		if (llmsResponse.ok) return { content: [{
-			type: "text",
-			text: await llmsResponse.text()
 		}] };
-	} catch (_) {}
-	return {
-		isError: true,
-		errorMessage: `There was an error fetching documentation for ${name}. Ensure the component exists.`,
-		content: []
-	};
-});
-server.registerTool("get_component_batch", {
-	description: "Retrieve official documentation and usage details for 2 to 10 React components from the @primer/react package in one call. Use get_component for exactly one component.",
-	inputSchema: { names: z.array(z.string()).min(2).max(10).describe("Component names to retrieve (e.g. [\"ActionMenu\", \"Button\", \"Pagination\"])") },
-	annotations: { readOnlyHint: true }
-}, async ({ names }) => {
-	const seenNames = /* @__PURE__ */ new Set();
-	const deduped = names.filter((name) => {
-		const normalizedName = name.toLowerCase();
-		if (seenNames.has(normalizedName)) return false;
-		seenNames.add(normalizedName);
-		return true;
 	});
-	const components = listComponents();
-	return { content: await Promise.all(deduped.map(async (name) => {
-		const match = components.find((component) => component.name === name || component.name.toLowerCase() === name.toLowerCase());
+	server.registerTool("get_component", {
+		description: "Retrieve official documentation and usage details for exactly one React component from the @primer/react package. Use get_component_batch for 2 to 10 components.",
+		inputSchema: z.object({ name: z.string().describe("The name of the component to retrieve") }),
+		annotations: { readOnlyHint: true }
+	}, async ({ name }) => {
+		const match = listComponents().find((component) => {
+			return component.name === name || component.name.toLowerCase() === name.toLowerCase();
+		});
 		if (!match) return {
-			type: "text",
-			text: `## ${name}\n\nStatus: not-found. No component named \`${name}\` exists in @primer/react. Use \`list_components\` for valid names.`
+			isError: true,
+			errorMessage: `There is no component named \`${name}\` in the @primer/react package. For a full list of components, use the \`list_components\` tool.`,
+			content: []
 		};
-		const controller = new AbortController();
-		const timeout = setTimeout(() => controller.abort(), 1e4);
 		try {
 			const llmsUrl = new URL(`/product/components/${match.slug}/llms.txt`, "https://primer.style");
-			const llmsResponse = await fetch(llmsUrl, { signal: controller.signal });
-			if (llmsResponse.ok) return {
+			const llmsResponse = await fetch(llmsUrl);
+			if (llmsResponse.ok) return { content: [{
 				type: "text",
 				text: await llmsResponse.text()
-			};
-		} catch (_) {} finally {
-			clearTimeout(timeout);
-		}
+			}] };
+		} catch (_) {}
 		return {
-			type: "text",
-			text: `## ${match.name}\n\nStatus: fetch-error. Failed to load documentation for ${match.name}.`
+			isError: true,
+			errorMessage: `There was an error fetching documentation for ${name}. Ensure the component exists.`,
+			content: []
 		};
-	})) };
-});
-server.registerTool("get_component_examples", {
-	description: "Get examples for how to use a component from Primer React",
-	inputSchema: { name: z.string().describe("The name of the component to retrieve") },
-	annotations: { readOnlyHint: true }
-}, async ({ name }) => {
-	const match = listComponents().find((component) => {
-		return component.name === name;
 	});
-	if (!match) return { content: [{
-		type: "text",
-		text: `There is no component named \`${name}\` in the @primer/react package. For a full list of components, use the \`get_components\` tool.`
-	}] };
-	const url = new URL(`/product/components/${match.id}`, "https://primer.style");
-	const response = await fetch(url);
-	if (!response.ok) throw new Error(`Failed to fetch ${url}: ${response.statusText}`);
-	const html = await response.text();
-	if (!html) return { content: [] };
-	const source = cheerio.load(html)("main").html();
-	if (!source) return { content: [] };
-	return { content: [{
-		type: "text",
-		text: `Here are some examples of how to use the \`${name}\` component from the @primer/react package:
+	server.registerTool("get_component_batch", {
+		description: "Retrieve official documentation and usage details for 2 to 10 React components from the @primer/react package in one call. Use get_component for exactly one component.",
+		inputSchema: z.object({ names: z.array(z.string()).min(2).max(10).describe("Component names to retrieve (e.g. [\"ActionMenu\", \"Button\", \"Pagination\"])") }),
+		annotations: { readOnlyHint: true }
+	}, async ({ names }) => {
+		const seenNames = /* @__PURE__ */ new Set();
+		const deduped = names.filter((name) => {
+			const normalizedName = name.toLowerCase();
+			if (seenNames.has(normalizedName)) return false;
+			seenNames.add(normalizedName);
+			return true;
+		});
+		const components = listComponents();
+		return { content: await Promise.all(deduped.map(async (name) => {
+			const match = components.find((component) => component.name === name || component.name.toLowerCase() === name.toLowerCase());
+			if (!match) return {
+				type: "text",
+				text: `## ${name}\n\nStatus: not-found. No component named \`${name}\` exists in @primer/react. Use \`list_components\` for valid names.`
+			};
+			const controller = new AbortController();
+			const timeout = setTimeout(() => controller.abort(), 1e4);
+			try {
+				const llmsUrl = new URL(`/product/components/${match.slug}/llms.txt`, "https://primer.style");
+				const llmsResponse = await fetch(llmsUrl, { signal: controller.signal });
+				if (llmsResponse.ok) return {
+					type: "text",
+					text: await llmsResponse.text()
+				};
+			} catch (_) {} finally {
+				clearTimeout(timeout);
+			}
+			return {
+				type: "text",
+				text: `## ${match.name}\n\nStatus: fetch-error. Failed to load documentation for ${match.name}.`
+			};
+		})) };
+	});
+	server.registerTool("get_component_examples", {
+		description: "Get examples for how to use a component from Primer React",
+		inputSchema: z.object({ name: z.string().describe("The name of the component to retrieve") }),
+		annotations: { readOnlyHint: true }
+	}, async ({ name }) => {
+		const match = listComponents().find((component) => {
+			return component.name === name;
+		});
+		if (!match) return { content: [{
+			type: "text",
+			text: `There is no component named \`${name}\` in the @primer/react package. For a full list of components, use the \`list_components\` tool.`
+		}] };
+		const url = new URL(`/product/components/${match.id}`, "https://primer.style");
+		const response = await fetch(url);
+		if (!response.ok) throw new Error(`Failed to fetch ${url}: ${response.statusText}`);
+		const html = await response.text();
+		if (!html) return { content: [] };
+		const source = cheerio.load(html)("main").html();
+		if (!source) return { content: [] };
+		return { content: [{
+			type: "text",
+			text: `Here are some examples of how to use the \`${name}\` component from the @primer/react package:
 
 ${turndownService.turndown(source)}`
-	}] };
-});
-server.registerTool("get_component_usage_guidelines", {
-	description: "Get usage information for how to use a component from Primer",
-	inputSchema: { name: z.string().describe("The name of the component to retrieve") },
-	annotations: { readOnlyHint: true }
-}, async ({ name }) => {
-	const match = listComponents().find((component) => {
-		return component.name === name;
+		}] };
 	});
-	if (!match) return { content: [{
-		type: "text",
-		text: `There is no component named \`${name}\` in the @primer/react package. For a full list of components, use the \`get_components\` tool.`
-	}] };
-	const url = new URL(`/product/components/${match.id}/guidelines`, "https://primer.style");
-	const response = await fetch(url);
-	if (!response.ok) {
-		if (response.status >= 400 && response.status < 500 || response.status >= 300 && response.status < 400) return { content: [{
+	server.registerTool("get_component_usage_guidelines", {
+		description: "Get usage information for how to use a component from Primer",
+		inputSchema: z.object({ name: z.string().describe("The name of the component to retrieve") }),
+		annotations: { readOnlyHint: true }
+	}, async ({ name }) => {
+		const match = listComponents().find((component) => {
+			return component.name === name;
+		});
+		if (!match) return { content: [{
 			type: "text",
-			text: `There are no accessibility guidelines for the \`${name}\` component in the @primer/react package.`
+			text: `There is no component named \`${name}\` in the @primer/react package. For a full list of components, use the \`get_components\` tool.`
 		}] };
-		throw new Error(`Failed to fetch ${url}: ${response.statusText}`);
-	}
-	const html = await response.text();
-	if (!html) return { content: [] };
-	const source = cheerio.load(html)("main").html();
-	if (!source) return { content: [] };
-	return { content: [{
-		type: "text",
-		text: `Here are the usage guidelines for the \`${name}\` component from the @primer/react package:
+		const url = new URL(`/product/components/${match.id}/guidelines`, "https://primer.style");
+		const response = await fetch(url);
+		if (!response.ok) {
+			if (response.status >= 400 && response.status < 500 || response.status >= 300 && response.status < 400) return { content: [{
+				type: "text",
+				text: `There are no accessibility guidelines for the \`${name}\` component in the @primer/react package.`
+			}] };
+			throw new Error(`Failed to fetch ${url}: ${response.statusText}`);
+		}
+		const html = await response.text();
+		if (!html) return { content: [] };
+		const source = cheerio.load(html)("main").html();
+		if (!source) return { content: [] };
+		return { content: [{
+			type: "text",
+			text: `Here are the usage guidelines for the \`${name}\` component from the @primer/react package:
 
 ${turndownService.turndown(source)}`
-	}] };
-});
-server.registerTool("get_component_accessibility_guidelines", {
-	description: "Retrieve accessibility guidelines and best practices for a specific component from the @primer/react package by its name. Use this tool to get official accessibility recommendations, usage tips, and requirements to ensure your UI components are inclusive and meet accessibility standards.",
-	inputSchema: { name: z.string().describe("The name of the component to retrieve") },
-	annotations: { readOnlyHint: true }
-}, async ({ name }) => {
-	const match = listComponents().find((component) => {
-		return component.name === name;
+		}] };
 	});
-	if (!match) return { content: [{
-		type: "text",
-		text: `There is no component named \`${name}\` in the @primer/react package. For a full list of components, use the \`list_components\` tool.`
-	}] };
-	const url = new URL(`/product/components/${match.id}/accessibility`, "https://primer.style");
-	const response = await fetch(url);
-	if (!response.ok) {
-		if (response.status >= 400 && response.status < 500 || response.status >= 300 && response.status < 400) return { content: [{
+	server.registerTool("get_component_accessibility_guidelines", {
+		description: "Retrieve accessibility guidelines and best practices for a specific component from the @primer/react package by its name. Use this tool to get official accessibility recommendations, usage tips, and requirements to ensure your UI components are inclusive and meet accessibility standards.",
+		inputSchema: z.object({ name: z.string().describe("The name of the component to retrieve") }),
+		annotations: { readOnlyHint: true }
+	}, async ({ name }) => {
+		const match = listComponents().find((component) => {
+			return component.name === name;
+		});
+		if (!match) return { content: [{
 			type: "text",
-			text: `There are no accessibility guidelines for the \`${name}\` component in the @primer/react package.`
+			text: `There is no component named \`${name}\` in the @primer/react package. For a full list of components, use the \`list_components\` tool.`
 		}] };
-		throw new Error(`Failed to fetch ${url}: ${response.statusText}`);
-	}
-	const html = await response.text();
-	if (!html) return { content: [] };
-	const source = cheerio.load(html)("main").html();
-	if (!source) return { content: [] };
-	return { content: [{
-		type: "text",
-		text: `Here are the accessibility guidelines for the \`${name}\` component from the @primer/react package:
+		const url = new URL(`/product/components/${match.id}/accessibility`, "https://primer.style");
+		const response = await fetch(url);
+		if (!response.ok) {
+			if (response.status >= 400 && response.status < 500 || response.status >= 300 && response.status < 400) return { content: [{
+				type: "text",
+				text: `There are no accessibility guidelines for the \`${name}\` component in the @primer/react package.`
+			}] };
+			throw new Error(`Failed to fetch ${url}: ${response.statusText}`);
+		}
+		const html = await response.text();
+		if (!html) return { content: [] };
+		const source = cheerio.load(html)("main").html();
+		if (!source) return { content: [] };
+		return { content: [{
+			type: "text",
+			text: `Here are the accessibility guidelines for the \`${name}\` component from the @primer/react package:
 
 ${turndownService.turndown(source)}`
-	}] };
-});
-server.registerTool("list_patterns", {
-	description: "List all of the patterns available from Primer React. Scenario patterns describe specific user tasks (copy, delete, filter, search). Prefer a scenario pattern when one fits the task, and fall back to the more generic UI patterns otherwise.",
-	annotations: { readOnlyHint: true }
-}, async () => {
-	const all = listPatterns();
-	const scenario = all.filter((pattern) => pattern.category === "scenario").map((pattern) => `- ${pattern.name}`);
-	const ui = all.filter((pattern) => pattern.category === "ui").map((pattern) => `- ${pattern.name}`);
-	return { content: [{
-		type: "text",
-		text: `The following patterns are available from \`@primer/react\` for use in TypeScript projects. Scenario patterns describe specific user tasks. Prefer a scenario pattern when one fits the task, and fall back to the UI patterns otherwise.
+		}] };
+	});
+	server.registerTool("list_patterns", {
+		description: "List all of the patterns available from Primer React. Scenario patterns describe specific user tasks (copy, delete, filter, search). Prefer a scenario pattern when one fits the task, and fall back to the more generic UI patterns otherwise.",
+		annotations: { readOnlyHint: true }
+	}, async () => {
+		const all = listPatterns();
+		const scenario = all.filter((pattern) => pattern.category === "scenario").map((pattern) => `- ${pattern.name}`);
+		const ui = all.filter((pattern) => pattern.category === "ui").map((pattern) => `- ${pattern.name}`);
+		return { content: [{
+			type: "text",
+			text: `The following patterns are available from \`@primer/react\` for use in TypeScript projects. Scenario patterns describe specific user tasks. Prefer a scenario pattern when one fits the task, and fall back to the UI patterns otherwise.
 
 ## Scenario patterns
 
@@ -911,65 +917,66 @@ ${scenario.join("\n")}
 ## UI patterns
 
 ${ui.join("\n")}`
-	}] };
-});
-server.registerTool("get_pattern", {
-	description: "Get a specific pattern by name. Scenario patterns describe specific user tasks (copy, delete, filter, search). Prefer a scenario pattern when one fits the task, and fall back to the more generic UI patterns otherwise.",
-	inputSchema: { name: z.string().describe("The name of the pattern to retrieve") },
-	annotations: { readOnlyHint: true }
-}, async ({ name }) => {
-	const patterns = listPatterns();
-	const match = patterns.find((pattern) => pattern.category === "scenario" && pattern.name === name) ?? patterns.find((pattern) => pattern.name === name);
-	if (!match) return { content: [{
-		type: "text",
-		text: `There is no pattern named \`${name}\` in the @primer/react package. For a full list of patterns, use the \`list_patterns\` tool.`
-	}] };
-	const basePath = match.category === "scenario" ? "scenario-patterns" : "ui-patterns";
-	const url = new URL(`/product/${basePath}/${match.id}`, "https://primer.style");
-	const response = await fetch(url);
-	if (!response.ok) throw new Error(`Failed to fetch ${url} - ${response.statusText}`);
-	const html = await response.text();
-	if (!html) return { content: [] };
-	const source = cheerio.load(html)("main").html();
-	if (!source) return { content: [] };
-	return { content: [{
-		type: "text",
-		text: `Here are the guidelines for the \`${name}\` pattern for Primer:
+		}] };
+	});
+	server.registerTool("get_pattern", {
+		description: "Get a specific pattern by name. Scenario patterns describe specific user tasks (copy, delete, filter, search). Prefer a scenario pattern when one fits the task, and fall back to the more generic UI patterns otherwise.",
+		inputSchema: z.object({ name: z.string().describe("The name of the pattern to retrieve") }),
+		annotations: { readOnlyHint: true }
+	}, async ({ name }) => {
+		const patterns = listPatterns();
+		const match = patterns.find((pattern) => pattern.category === "scenario" && pattern.name === name) ?? patterns.find((pattern) => pattern.name === name);
+		if (!match) return { content: [{
+			type: "text",
+			text: `There is no pattern named \`${name}\` in the @primer/react package. For a full list of patterns, use the \`list_patterns\` tool.`
+		}] };
+		const basePath = match.category === "scenario" ? "scenario-patterns" : "ui-patterns";
+		const url = new URL(`/product/${basePath}/${match.id}`, "https://primer.style");
+		const response = await fetch(url);
+		if (!response.ok) throw new Error(`Failed to fetch ${url} - ${response.statusText}`);
+		const html = await response.text();
+		if (!html) return { content: [] };
+		const source = cheerio.load(html)("main").html();
+		if (!source) return { content: [] };
+		return { content: [{
+			type: "text",
+			text: `Here are the guidelines for the \`${name}\` pattern for Primer:
 
 ${turndownService.turndown(source)}`
-	}] };
-});
-server.registerTool("find_tokens", {
-	description: "Search for specific tokens. Tip: If you only provide a 'group' and leave 'query' empty, it returns all tokens in that category. Avoid property-by-property searching. COLOR RESOLUTION: If a user asks for \"pink\" or \"blue\", do not search for the color name. Use the semantic intent: blue->accent, red->danger, green->success. Always check both \"emphasis\" and \"muted\" variants for background colors. After identifying tokens and writing CSS, you MUST validate the result using lint_css.",
-	inputSchema: {
-		query: z.string().optional().default("").describe("Search keywords (e.g., \"danger border\", \"success background\")"),
-		group: z.string().optional().describe("Filter by group (e.g., \"fgColor\", \"border\")"),
-		limit: z.number().int().min(1).max(100).optional().default(15).describe("Maximum results to return to stay within context limits")
-	},
-	annotations: { readOnlyHint: true }
-}, async ({ query, group, limit }) => {
-	const resolvedGroup = group ? GROUP_ALIASES[group.toLowerCase().replace(/\s+/g, "")] || group : void 0;
-	const rawKeywords = query.toLowerCase().split(/\s+/).filter((k) => k.length > 0);
-	let effectiveGroup = resolvedGroup;
-	const filteredKeywords = [];
-	for (const kw of rawKeywords) {
-		const aliasMatch = GROUP_ALIASES[kw.replace(/\s+/g, "")];
-		if (aliasMatch && !effectiveGroup) effectiveGroup = aliasMatch;
-		else filteredKeywords.push(kw);
-	}
-	if (filteredKeywords.length === 0 && !effectiveGroup) return { content: [{
-		type: "text",
-		text: "Please provide a query, a group, or both. Call `get_design_token_specs` to see available token groups."
-	}] };
-	const isGroupOnly = filteredKeywords.length === 0 && effectiveGroup;
-	let results;
-	if (isGroupOnly) results = allTokensWithGuidelines.filter((token) => tokenMatchesGroup(token, effectiveGroup));
-	else results = searchTokens(allTokensWithGuidelines, filteredKeywords.join(" "), effectiveGroup);
-	if (results.length === 0) {
-		const validGroups = getValidGroupsList(allTokensWithGuidelines);
-		return { content: [{
+		}] };
+	});
+	server.registerTool("find_tokens", {
+		description: "Search for specific tokens. Tip: If you only provide a 'group' and leave 'query' empty, it returns all tokens in that category. Avoid property-by-property searching. COLOR RESOLUTION: If a user asks for \"pink\" or \"blue\", do not search for the color name. Use the semantic intent: blue->accent, red->danger, green->success. Always check both \"emphasis\" and \"muted\" variants for background colors. After identifying tokens and writing CSS, you MUST validate the result using lint_css.",
+		inputSchema: z.object({
+			query: z.string().optional().default("").describe("Search keywords (e.g., \"danger border\", \"success background\")"),
+			group: z.string().optional().describe("Filter by group (e.g., \"fgColor\", \"border\")"),
+			limit: z.number().int().min(1).max(100).optional().default(15).describe("Maximum results to return to stay within context limits")
+		}),
+		annotations: { readOnlyHint: true }
+	}, async ({ query, group, limit }) => {
+		const resolvedGroup = group ? GROUP_ALIASES[group.toLowerCase().replace(/\s+/g, "")] || group : void 0;
+		const rawKeywords = query.toLowerCase().split(/\s+/).filter((k) => k.length > 0);
+		let effectiveGroup = resolvedGroup;
+		const filteredKeywords = [];
+		for (const kw of rawKeywords) {
+			const normalized = kw.replace(/\s+/g, "");
+			const aliasMatch = GROUP_ALIASES[normalized];
+			if (aliasMatch && !effectiveGroup) effectiveGroup = aliasMatch;
+			else filteredKeywords.push(kw);
+		}
+		if (filteredKeywords.length === 0 && !effectiveGroup) return { content: [{
 			type: "text",
-			text: `No tokens found matching "${query}"${effectiveGroup ? ` in group "${effectiveGroup}"` : ""}. 
+			text: "Please provide a query, a group, or both. Call `get_design_token_specs` to see available token groups."
+		}] };
+		const isGroupOnly = filteredKeywords.length === 0 && effectiveGroup;
+		let results;
+		if (isGroupOnly) results = allTokensWithGuidelines.filter((token) => tokenMatchesGroup(token, effectiveGroup));
+		else results = searchTokens(allTokensWithGuidelines, filteredKeywords.join(" "), effectiveGroup);
+		if (results.length === 0) {
+			const validGroups = getValidGroupsList(allTokensWithGuidelines);
+			return { content: [{
+				type: "text",
+				text: `No tokens found matching "${query}"${effectiveGroup ? ` in group "${effectiveGroup}"` : ""}.
 
 ### 💡 Available Groups:
 ${validGroups}
@@ -979,188 +986,189 @@ ${validGroups}
 2. **Property Mismatch**: Do not search for CSS properties like "offset", "padding", or "font-size". Use semantic intent keywords: "danger", "muted", "emphasis".
 3. **Typography**: Remember that \`caption\`, \`display\`, and \`code\` groups do NOT support size suffixes. Use the base shorthand only.
 4. **Group Intent**: Use the \`group\` parameter instead of putting group names in the \`query\` string (e.g., use group: "stack" instead of query: "stack padding").`
+			}] };
+		}
+		const limitedResults = results.slice(0, limit);
+		let output;
+		if (!query) output = `Found ${results.length} token(s). Showing top ${limitedResults.length}:\n\n`;
+		else output = `Found ${results.length} token(s) matching "${query}". Showing top ${limitedResults.length}:\n\n`;
+		output += formatBundle(limitedResults);
+		if (results.length > limit) output += `\n\n*...and ${results.length - limit} more matches. Use more specific keywords to narrow the search.*`;
+		return { content: [{
+			type: "text",
+			text: output
 		}] };
-	}
-	const limitedResults = results.slice(0, limit);
-	let output;
-	if (!query) output = `Found ${results.length} token(s). Showing top ${limitedResults.length}:\n\n`;
-	else output = `Found ${results.length} token(s) matching "${query}". Showing top ${limitedResults.length}:\n\n`;
-	output += formatBundle(limitedResults);
-	if (results.length > limit) output += `\n\n*...and ${results.length - limit} more matches. Use more specific keywords to narrow the search.*`;
-	return { content: [{
-		type: "text",
-		text: output
-	}] };
-});
-server.registerTool("get_token_group_bundle", {
-	description: "PREFERRED FOR COMPONENTS. Fetch all tokens for complex UI (e.g., Dialogs, Cards) in one call by providing an array of groups like ['overlay', 'shadow']. Use this instead of multiple find_tokens calls to save context.",
-	inputSchema: { groups: z.array(z.string()).describe("Array of group names (e.g., [\"overlay\", \"shadow\", \"focus\"])") },
-	annotations: { readOnlyHint: true }
-}, async ({ groups }) => {
-	const resolvedGroups = groups.map((g) => {
-		return GROUP_ALIASES[g.toLowerCase().replace(/\s+/g, "")] || g;
 	});
-	const matched = allTokensWithGuidelines.filter((token) => resolvedGroups.some((rg) => tokenMatchesGroup(token, rg)));
-	if (matched.length === 0) {
-		const validGroups = getValidGroupsList(allTokensWithGuidelines);
+	server.registerTool("get_token_group_bundle", {
+		description: "PREFERRED FOR COMPONENTS. Fetch all tokens for complex UI (e.g., Dialogs, Cards) in one call by providing an array of groups like ['overlay', 'shadow']. Use this instead of multiple find_tokens calls to save context.",
+		inputSchema: z.object({ groups: z.array(z.string()).describe("Array of group names (e.g., [\"overlay\", \"shadow\", \"focus\"])") }),
+		annotations: { readOnlyHint: true }
+	}, async ({ groups }) => {
+		const resolvedGroups = groups.map((g) => {
+			const normalized = g.toLowerCase().replace(/\s+/g, "");
+			return GROUP_ALIASES[normalized] || g;
+		});
+		const matched = allTokensWithGuidelines.filter((token) => resolvedGroups.some((rg) => tokenMatchesGroup(token, rg)));
+		if (matched.length === 0) {
+			const validGroups = getValidGroupsList(allTokensWithGuidelines);
+			return { content: [{
+				type: "text",
+				text: `No tokens found for groups: ${groups.join(", ")}.\n\n### Valid Groups:\n${validGroups}`
+			}] };
+		}
+		let text = `Found ${matched.length} token(s) across ${resolvedGroups.length} group(s):\n\n${formatBundle(matched)}`;
+		const activeHints = resolvedGroups.map((g) => groupHints[g]).filter(Boolean);
+		if (activeHints.length > 0) text += `\n\n### ⚠️ Usage Guidance:\n${activeHints.map((h) => `- ${h}`).join("\n")}`;
 		return { content: [{
 			type: "text",
-			text: `No tokens found for groups: ${groups.join(", ")}.\n\n### Valid Groups:\n${validGroups}`
+			text
 		}] };
-	}
-	let text = `Found ${matched.length} token(s) across ${resolvedGroups.length} group(s):\n\n${formatBundle(matched)}`;
-	const activeHints = resolvedGroups.map((g) => groupHints[g]).filter(Boolean);
-	if (activeHints.length > 0) text += `\n\n### ⚠️ Usage Guidance:\n${activeHints.map((h) => `- ${h}`).join("\n")}`;
-	return { content: [{
-		type: "text",
-		text
-	}] };
-});
-server.registerTool("get_design_token_specs", {
-	description: "CRITICAL: CALL THIS FIRST. Provides the logic matrix and the list of valid group names. You cannot search accurately without this map.",
-	annotations: { readOnlyHint: true }
-}, async () => {
-	const customRules = getDesignTokenSpecsText(listTokenGroups());
-	let text;
-	try {
-		text = `${customRules}\n\n---\n\n${loadDesignTokensGuide()}`;
-	} catch {
-		text = customRules;
-	}
-	return { content: [{
-		type: "text",
-		text
-	}] };
-});
-server.registerTool("get_token_usage_patterns", {
-	description: "Provides \"Golden Example\" CSS for core patterns: Button (Interactions) and Stack (Layout). Use this to understand how to apply the Logic Matrix, Motion, and Spacing scales.",
-	annotations: { readOnlyHint: true }
-}, async () => {
-	const customPatterns = getTokenUsagePatternsText();
-	let text;
-	try {
-		const goldenExampleMatch = loadDesignTokensGuide().match(/## Golden Example[\s\S]*?(?=\n## |$)/);
-		if (goldenExampleMatch) text = `${customPatterns}\n\n---\n\n${goldenExampleMatch[0].trim()}`;
-		else text = customPatterns;
-	} catch {
-		text = customPatterns;
-	}
-	return { content: [{
-		type: "text",
-		text
-	}] };
-});
-server.registerTool("lint_css", {
-	description: "REQUIRED FINAL STEP. Use this to validate your CSS. You cannot complete a task involving CSS without a successful run of this tool.",
-	inputSchema: { css: z.string() },
-	annotations: { readOnlyHint: true }
-}, async ({ css }) => {
-	try {
-		const { stdout } = await runStylelint(css);
+	});
+	server.registerTool("get_design_token_specs", {
+		description: "CRITICAL: CALL THIS FIRST. Provides the logic matrix and the list of valid group names. You cannot search accurately without this map.",
+		annotations: { readOnlyHint: true }
+	}, async () => {
+		const customRules = getDesignTokenSpecsText(listTokenGroups());
+		let text;
+		try {
+			text = `${customRules}\n\n---\n\n${loadDesignTokensGuide()}`;
+		} catch {
+			text = customRules;
+		}
 		return { content: [{
 			type: "text",
-			text: stdout || "✅ Stylelint passed (or was successfully autofixed)."
+			text
 		}] };
-	} catch (error) {
+	});
+	server.registerTool("get_token_usage_patterns", {
+		description: "Provides \"Golden Example\" CSS for core patterns: Button (Interactions) and Stack (Layout). Use this to understand how to apply the Logic Matrix, Motion, and Spacing scales.",
+		annotations: { readOnlyHint: true }
+	}, async () => {
+		const customPatterns = getTokenUsagePatternsText();
+		let text;
+		try {
+			const goldenExampleMatch = loadDesignTokensGuide().match(/## Golden Example[\s\S]*?(?=\n## |$)/);
+			if (goldenExampleMatch) text = `${customPatterns}\n\n---\n\n${goldenExampleMatch[0].trim()}`;
+			else text = customPatterns;
+		} catch {
+			text = customPatterns;
+		}
 		return { content: [{
 			type: "text",
-			text: `❌ Errors without autofix remaining:\n${error instanceof Error && "stdout" in error ? error.stdout : String(error)}`
+			text
 		}] };
-	}
-});
-server.registerTool("get_color_usage", {
-	description: "Get the guidelines for how to apply color to a user interface",
-	annotations: { readOnlyHint: true }
-}, async () => {
-	const url = new URL(`/product/getting-started/foundations/color-usage`, "https://primer.style");
-	const response = await fetch(url);
-	if (!response.ok) throw new Error(`Failed to fetch ${url} - ${response.statusText}`);
-	const html = await response.text();
-	if (!html) return { content: [] };
-	const source = cheerio.load(html)("main").html();
-	if (!source) return { content: [] };
-	return { content: [{
-		type: "text",
-		text: `Here is the documentation for color usage in Primer:\n\n${turndownService.turndown(source)}`
-	}] };
-});
-server.registerTool("get_typography_usage", {
-	description: "Get the guidelines for how to apply typography to a user interface",
-	annotations: { readOnlyHint: true }
-}, async () => {
-	const url = new URL(`/product/getting-started/foundations/typography`, "https://primer.style");
-	const response = await fetch(url);
-	if (!response.ok) throw new Error(`Failed to fetch ${url} - ${response.statusText}`);
-	const html = await response.text();
-	if (!html) return { content: [] };
-	const source = cheerio.load(html)("main").html();
-	if (!source) return { content: [] };
-	return { content: [{
-		type: "text",
-		text: `Here is the documentation for typography usage in Primer:\n\n${turndownService.turndown(source)}`
-	}] };
-});
-server.registerTool("list_icons", {
-	description: "List all of the icons (octicons) available from Primer Octicons React",
-	annotations: { readOnlyHint: true }
-}, async () => {
-	return { content: [{
-		type: "text",
-		text: `The following icons are available in the @primer/octicons-react package in TypeScript projects:
+	});
+	server.registerTool("lint_css", {
+		description: "REQUIRED FINAL STEP. Use this to validate your CSS. You cannot complete a task involving CSS without a successful run of this tool.",
+		inputSchema: z.object({ css: z.string() }),
+		annotations: { readOnlyHint: true }
+	}, async ({ css }) => {
+		try {
+			const { stdout } = await runStylelint(css);
+			return { content: [{
+				type: "text",
+				text: stdout || "✅ Stylelint passed (or was successfully autofixed)."
+			}] };
+		} catch (error) {
+			return { content: [{
+				type: "text",
+				text: `❌ Errors without autofix remaining:\n${error instanceof Error && "stdout" in error ? error.stdout : String(error)}`
+			}] };
+		}
+	});
+	server.registerTool("get_color_usage", {
+		description: "Get the guidelines for how to apply color to a user interface",
+		annotations: { readOnlyHint: true }
+	}, async () => {
+		const url = new URL(`/product/getting-started/foundations/color-usage`, "https://primer.style");
+		const response = await fetch(url);
+		if (!response.ok) throw new Error(`Failed to fetch ${url} - ${response.statusText}`);
+		const html = await response.text();
+		if (!html) return { content: [] };
+		const source = cheerio.load(html)("main").html();
+		if (!source) return { content: [] };
+		return { content: [{
+			type: "text",
+			text: `Here is the documentation for color usage in Primer:\n\n${turndownService.turndown(source)}`
+		}] };
+	});
+	server.registerTool("get_typography_usage", {
+		description: "Get the guidelines for how to apply typography to a user interface",
+		annotations: { readOnlyHint: true }
+	}, async () => {
+		const url = new URL(`/product/getting-started/foundations/typography`, "https://primer.style");
+		const response = await fetch(url);
+		if (!response.ok) throw new Error(`Failed to fetch ${url} - ${response.statusText}`);
+		const html = await response.text();
+		if (!html) return { content: [] };
+		const source = cheerio.load(html)("main").html();
+		if (!source) return { content: [] };
+		return { content: [{
+			type: "text",
+			text: `Here is the documentation for typography usage in Primer:\n\n${turndownService.turndown(source)}`
+		}] };
+	});
+	server.registerTool("list_icons", {
+		description: "List all of the icons (octicons) available from Primer Octicons React",
+		annotations: { readOnlyHint: true }
+	}, async () => {
+		return { content: [{
+			type: "text",
+			text: `The following icons are available in the @primer/octicons-react package in TypeScript projects:
 
 ${listIcons().map((icon) => {
-			const keywords = icon.keywords.map((keyword) => {
-				return `<keyword>${keyword}</keyword>`;
-			});
-			const sizes = icon.heights.map((height) => {
-				return `<size value="${height}"></size>`;
-			});
-			return [
-				`<icon name="${icon.name}">`,
-				...keywords,
-				...sizes,
-				`</icon>`
-			].join("\n");
-		}).join("\n")}
+				const keywords = icon.keywords.map((keyword) => {
+					return `<keyword>${keyword}</keyword>`;
+				});
+				const sizes = icon.heights.map((height) => {
+					return `<size value="${height}"></size>`;
+				});
+				return [
+					`<icon name="${icon.name}">`,
+					...keywords,
+					...sizes,
+					`</icon>`
+				].join("\n");
+			}).join("\n")}
 
 You can use the \`get_icon\` tool to get more information about a specific icon. You can use these components from the @primer/octicons-react package.`
-	}] };
-});
-server.registerTool("get_icon", {
-	description: "Get a specific icon (octicon) by name from Primer",
-	inputSchema: {
-		name: z.string().describe("The name of the icon to retrieve"),
-		size: z.string().optional().describe("The size of the icon to retrieve, e.g. \"16\"").default("16")
-	},
-	annotations: { readOnlyHint: true }
-}, async ({ name, size }) => {
-	const match = listIcons().find((icon) => {
-		return icon.name === name || icon.name.toLowerCase() === name.toLowerCase();
+		}] };
 	});
-	if (!match) return { content: [{
-		type: "text",
-		text: `There is no icon named \`${name}\` in the @primer/octicons-react package. For a full list of icons, use the \`get_icon\` tool.`
-	}] };
-	const url = new URL(`/octicons/icon/${match.name}-${size}`, "https://primer.style");
-	const response = await fetch(url);
-	if (!response.ok) throw new Error(`Failed to fetch ${url}: ${response.statusText}`);
-	const html = await response.text();
-	if (!html) return { content: [] };
-	const source = cheerio.load(html)("main").html();
-	if (!source) return { content: [] };
-	return { content: [{
-		type: "text",
-		text: `Here is the documentation for the \`${name}\` icon at size: \`${size}\`:
+	server.registerTool("get_icon", {
+		description: "Get a specific icon (octicon) by name from Primer",
+		inputSchema: z.object({
+			name: z.string().describe("The name of the icon to retrieve"),
+			size: z.string().optional().describe("The size of the icon to retrieve, e.g. \"16\"").default("16")
+		}),
+		annotations: { readOnlyHint: true }
+	}, async ({ name, size }) => {
+		const match = listIcons().find((icon) => {
+			return icon.name === name || icon.name.toLowerCase() === name.toLowerCase();
+		});
+		if (!match) return { content: [{
+			type: "text",
+			text: `There is no icon named \`${name}\` in the @primer/octicons-react package. For a full list of icons, use the \`get_icon\` tool.`
+		}] };
+		const url = new URL(`/octicons/icon/${match.name}-${size}`, "https://primer.style");
+		const response = await fetch(url);
+		if (!response.ok) throw new Error(`Failed to fetch ${url}: ${response.statusText}`);
+		const html = await response.text();
+		if (!html) return { content: [] };
+		const source = cheerio.load(html)("main").html();
+		if (!source) return { content: [] };
+		return { content: [{
+			type: "text",
+			text: `Here is the documentation for the \`${name}\` icon at size: \`${size}\`:
 ${turndownService.turndown(source)}`
-	}] };
-});
-server.registerTool("primer_coding_guidelines", {
-	description: "Get the guidelines when writing code that uses Primer or for UI code that you are creating",
-	annotations: { readOnlyHint: true }
-}, async () => {
-	return { content: [{
-		type: "text",
-		text: `When writing code that uses Primer, follow these guidelines:
+		}] };
+	});
+	server.registerTool("primer_coding_guidelines", {
+		description: "Get the guidelines when writing code that uses Primer or for UI code that you are creating",
+		annotations: { readOnlyHint: true }
+	}, async () => {
+		return { content: [{
+			type: "text",
+			text: `When writing code that uses Primer, follow these guidelines:
 
 ## Design Tokens
 
@@ -1182,46 +1190,51 @@ The following list of coding guidelines must be followed:
 - Do not use the sx prop for styling components. Instead, use CSS Modules.
 - Do not use the Box component for styling components. Instead, use CSS Modules.
 `
-	}] };
-});
-/**
-* The `review_alt_text` tool is experimental and may be removed in future versions.
-*
-* The intent of this tool is to assist products like Copilot Code Review and Copilot Coding Agent
-* in reviewing both user- and AI-generated alt text for images, ensuring compliance with accessibility guidelines.
-* This tool is not intended to replace human-generated alt text; rather, it supports the review process
-* by providing suggestions for improvement. It should be used alongside human review, not as a substitute.
-*
-*
-**/
-server.registerTool("review_alt_text", {
-	description: "Evaluates image alt text against accessibility best practices and context relevance.",
-	inputSchema: {
-		surroundingText: z.string().describe("Text surrounding the image, relevant to the image."),
-		alt: z.string().describe("The alt text of the image being evaluated"),
-		image: z.string().describe("The image URL or file path being evaluated")
-	},
-	annotations: { readOnlyHint: true }
-}, async ({ surroundingText, alt, image }) => {
-	const response = await server.server.createMessage({
-		messages: [{
-			role: "user",
-			content: {
+		}] };
+	});
+	/**
+	* The `review_alt_text` tool is experimental and may be removed in future versions.
+	*
+	* The intent of this tool is to assist products like Copilot Code Review and Copilot Coding Agent
+	* in reviewing both user- and AI-generated alt text for images, ensuring compliance with accessibility guidelines.
+	* This tool is not intended to replace human-generated alt text; rather, it supports the review process
+	* by providing suggestions for improvement. It should be used alongside human review, not as a substitute.
+	*
+	*
+	**/
+	server.registerTool("review_alt_text", {
+		description: "Evaluates image alt text against accessibility best practices and context relevance.",
+		inputSchema: z.object({
+			surroundingText: z.string().describe("Text surrounding the image, relevant to the image."),
+			alt: z.string().describe("The alt text of the image being evaluated"),
+			image: z.string().describe("The image URL or file path being evaluated")
+		}),
+		annotations: { readOnlyHint: true }
+	}, async ({ surroundingText, alt, image }, context) => {
+		const response = inputResponse(context.mcpReq.inputResponses, "altTextEvaluation");
+		if (response.kind !== "sampling") return inputRequired({ inputRequests: { altTextEvaluation: inputRequired.createMessage({
+			messages: [{
+				role: "user",
+				content: {
+					type: "text",
+					text: `Does this alt text: '${alt}' meet accessibility guidelines and describe the image: ${image} accurately in context of this surrounding text: '${surroundingText}'?\n\n`
+				}
+			}],
+			temperature: .4,
+			maxTokens: 500
+		}) } });
+		const evaluation = (Array.isArray(response.result.content) ? response.result.content : [response.result.content]).filter((block) => block.type === "text").map((block) => block.text).join("\n") || "Unable to generate summary";
+		return {
+			content: [{
 				type: "text",
-				text: `Does this alt text: '${alt}' meet accessibility guidelines and describe the image: ${image} accurately in context of this surrounding text: '${surroundingText}'?\n\n`
-			}
-		}],
-		temperature: .4,
-		maxTokens: 500
+				text: evaluation
+			}],
+			altTextEvaluation: evaluation,
+			nextSteps: `If the evaluation indicates issues with the alt text, provide more meaningful alt text based on the feedback. DO NOT run this tool repeatedly on the same image - evaluations may vary slightly with each run.`
+		};
 	});
-	return {
-		content: [{
-			type: "text",
-			text: response.content.type === "text" ? response.content.text : "Unable to generate summary"
-		}],
-		altTextEvaluation: response.content.type === "text" ? response.content.text : "Unable to generate summary",
-		nextSteps: `If the evaluation indicates issues with the alt text, provide more meaningful alt text based on the feedback. DO NOT run this tool repeatedly on the same image - evaluations may vary slightly with each run.`
-	};
-});
+	return server;
+}
+const server = createServer();
 //#endregion
-export { server as t };
+export { server as n, createServer as t };