check

Instructions

Implementation Reference

• src/index.ts:34-52 (registration)

  Registration of the 'check' tool via server.addTool, with its name, description, Zod schema, and execute handler

  server.addTool({
  	name: "check",
  	description:
  		"Check if the text is a valid mermaid diagram. Returns an empty string if valid, otherwise returns the error message.",
  	parameters: z.object({
  		text: z.string(),
  	}),
  	execute: async (args) => {
  		try {
  			const { status, message } = await checkMermaid(args.text);
  			return status === ParseStatus.SUCCESS ? "" : message || "Unknown error";
  		} catch (error) {
  			const errorMessage =
  				error instanceof Error ? error.message : "Unexpected error occurred";
  			console.error("Error in check tool:", errorMessage);
  			return `Internal error: ${errorMessage}`;
  		}
  	},
  });

• src/index.ts:38-40 (schema)

  Input schema for the 'check' tool using Zod: accepts a single string parameter 'text'

  parameters: z.object({
  	text: z.string(),
  }),

• src/check.ts:17-47 (handler)

  Handler function 'checkMermaid' that validates input, writes text to a temp file, and calls parseMermaid to check syntax

  export const checkMermaid = async (text: string): Promise<ParseResult> => {
  	// Input validation
  	if (typeof text !== "string") {
  		return {
  			status: ParseStatus.FAIL,
  			message: "Input must be a string",
  		};
  	}
  
  	// Check for empty or whitespace-only content
  	if (!text.trim()) {
  		return {
  			status: ParseStatus.FAIL,
  			message: "Input cannot be empty or contain only whitespace",
  		};
  	}
  
  	const inputFilePath = path.join(__dirname, "input.mmd");
  
  	try {
  		fs.writeFileSync(inputFilePath, text, { encoding: "utf-8" });
  		return await parseMermaid();
  	} catch (error) {
  		const errorMessage =
  			error instanceof Error ? error.message : "File write failed";
  		return {
  			status: ParseStatus.FAIL,
  			message: `Unable to write temporary file: ${errorMessage}`,
  		};
  	}
  };

• src/index.ts:41-51 (handler)

  Inline execute handler that calls checkMermaid and maps ParseResult to a response string

  execute: async (args) => {
  	try {
  		const { status, message } = await checkMermaid(args.text);
  		return status === ParseStatus.SUCCESS ? "" : message || "Unknown error";
  	} catch (error) {
  		const errorMessage =
  			error instanceof Error ? error.message : "Unexpected error occurred";
  		console.error("Error in check tool:", errorMessage);
  		return `Internal error: ${errorMessage}`;
  	}
  },

• src/parse.ts:65-90 (helper)

  Helper function 'parseMermaid' that runs the mmdc CLI tool to validate Mermaid syntax

  export const parseMermaid = (
  	inputFile: string = "input.mmd",
  	outputFile: string = "output.svg",
  ): Promise<ParseResult> => {
  	return new Promise((resolve) => {
  		const inputPath = path.join(__dirname, inputFile);
  		const outputPath = path.join(__dirname, outputFile);
  
  		exec(
  			`npx mmdc -i ${inputPath} -o ${outputPath}`,
  			(err, _stdout, stderr) => {
  				if (err) {
  					const errorOutput = stderr || err.message || "";
  					const filteredMessage = filterErrorOutput(errorOutput);
  					resolve({
  						status: ParseStatus.FAIL,
  						message: filteredMessage || err.message || "Unknown error",
  					});
  					return;
  				}
  
  				resolve({ status: ParseStatus.SUCCESS });
  			},
  		);
  	});
  };