@fruggr/zendesk-mcp-server 3.0.1 → 3.0.3

package/dist/index.js

@@ -1327,6 +1327,7 @@ const parseSections = (html) => {
 			current = {
 				heading: $(node).text().trim(),
 				headingTag: tagName,
+				headingHtml: $.html(node),
 				level,
 				contentParts: []
 			};
@@ -1344,6 +1345,7 @@ const parseSections = (html) => {
 			index: 0,
 			heading: "intro",
 			headingTag: "",
+			headingHtml: "",
 			level: 0,
 			html: introHtml,
 			wordCount: countWords(textOf(introHtml))
@@ -1355,6 +1357,7 @@ const parseSections = (html) => {
 			index: result.length,
 			heading: s.heading,
 			headingTag: s.headingTag,
+			headingHtml: s.headingHtml,
 			level: s.level,
 			html: sectionHtml,
 			wordCount: countWords(textOf(sectionHtml))
@@ -1365,11 +1368,7 @@ const parseSections = (html) => {
 const replaceSectionContent = (html, sectionIndex, newHtml) => {
 	const sections = parseSections(html);
 	if (sectionIndex < 0 || sectionIndex >= sections.length) throw new Error(`Section index ${sectionIndex} out of range (valid: 0-${Math.max(0, sections.length - 1)})`);
-	return sections.map((section, idx) => {
-		const content = idx === sectionIndex ? newHtml : section.html;
-		if (section.level === 0) return content;
-		return `<${section.headingTag}>${section.heading}</${section.headingTag}>${content}`;
-	}).join("");
+	return sections.map((section, idx) => `${section.headingHtml}${idx === sectionIndex ? newHtml : section.html}`).join("");
 };
 const LEADING_HEADING = /^\s*<(h[1-3])(?:\s[^>]*)?>([\s\S]*?)<\/\1\s*>/i;
 const normalizeText = (text) => text.trim().split(WHITESPACE_RUN).join(" ");
@@ -2083,6 +2082,23 @@ const createTopologyProvider = (getToken, subdomain, onUnauthorized) => {
 		return promise;
 	} };
 };
+const PARAMS_FIELD_DESCRIPTION = "Parameters of the chosen operation, named exactly as its line in \"operation\" lists them (* = required). An unknown name is rejected.";
+const summarizeDescription = (description) => {
+	const idx = description.indexOf(". ");
+	if (idx === -1) return description;
+	return description.slice(0, idx + 1);
+};
+const operationSignature = (tool) => {
+	const params = Object.entries(tool.inputSchema.shape).map(([key, field]) => field.safeParse(void 0).success ? key : `${key}*`);
+	return `${tool.name}(${params.join(", ")})`;
+};
+const buildOperationList = (tools) => tools.map((t) => `- ${operationSignature(t)}: ${summarizeDescription(t.description)}${t.readOnly ? "" : " (write)"}`).join("\n");
+const buildOperationFieldDescription = (tools) => `One of the operations below. Each line reads name(parameters): summary, where the parameters are the exact names "params" accepts and * marks a required one; (write) marks an operation that changes data.\n${buildOperationList(tools)}`;
+const buildProxyDescription = ({ title, tools, readOnly }) => {
+	const head = `${readOnly ? "[RO] " : ""}${title}. Specify the operation and its parameters. The "operation" field lists every operation with a one-line summary and the parameter names "params" accepts (* = required); an unknown parameter is rejected with the list of valid ones.`;
+	const withNames = `${head}\n\nOperations: ${tools.map((t) => t.name).join(", ")}`;
+	return withNames.length <= 2048 ? withNames : head;
+};
 //#endregion
 //#region src/routing/registry.ts
 /**
@@ -5198,12 +5214,6 @@ const runHandler = async (def, params, onUnauthorized) => {
 		throw err;
 	}
 };
-const summarizeDescription = (description) => {
-	const idx = description.indexOf(". ");
-	if (idx === -1) return description;
-	return description.slice(0, idx + 1);
-};
-const buildOperationList = (tools) => tools.map((t) => `- **${t.name}**: ${summarizeDescription(t.description)}${t.readOnly ? "" : " (write)"}`).join("\n");
 const aggregateAnnotations = (tools) => ({
 	readOnlyHint: tools.every((t) => t.annotations.readOnlyHint),
 	destructiveHint: tools.some((t) => t.annotations.destructiveHint),
@@ -5228,17 +5238,18 @@ const buildProxyDispatch = (tools, onUnauthorized) => {
 	};
 };
 const registerProxyTool = (server, toolName, title, tools, readOnlyMode, onUnauthorized) => {
-	const operationNames = tools.map((t) => t.name);
-	const operationList = buildOperationList(tools);
 	const annotations = aggregateAnnotations(tools);
-	const prefix = readOnlyMode ? "[RO] " : "";
 	const dispatch = buildProxyDispatch(tools, onUnauthorized);
 	return server.registerTool(toolName, {
 		title,
-		description: `${prefix}${title}. Specify the operation and its parameters.\n\nAvailable operations:\n${operationList}`,
+		description: buildProxyDescription({
+			title,
+			tools,
+			readOnly: readOnlyMode
+		}),
 		inputSchema: z.object({
-			operation: z.string().describe(`One of: ${operationNames.join(", ")}`),
-			params: z.record(z.string(), z.unknown()).default({}).describe("Operation parameters")
+			operation: z.string().describe(buildOperationFieldDescription(tools)),
+			params: z.record(z.string(), z.unknown()).default({}).describe(PARAMS_FIELD_DESCRIPTION)
 		}),
 		annotations
 	}, async (args) => dispatch(args));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fruggr/zendesk-mcp-server",
-  "version": "3.0.1",
+  "version": "3.0.3",
   "mcpName": "io.github.fruggr/zendesk-mcp-server",
   "description": "Deep Zendesk MCP server for your AI assistant: search, draft, update and translate Help Center articles and manage Support tickets end to end — comments, triage and image attachments.",
   "type": "module",
@@ -71,7 +71,7 @@
   "engines": {
     "node": ">=22"
   },
-  "packageManager": "pnpm@12.6.0+sha512.3ef68f951cb111ac204b4a5a16f0b2ddf0da56a96e0413e81d855d9f0b55ef926714709028e1cd00c405c2c5fb7b9e8ec4dc46777c805d0373c2f2ff00fd20ec",
+  "packageManager": "pnpm@12.5.1+sha512.e3f305bc784a2bc89f5ad3b6138889470fae8d2af5f36b61216ec91c2c3d64089775f9de38aac331044ea40f245cb0d5666392dfdf65824e1907ef6a2c62de5f",
   "dependencies": {
     "@modelcontextprotocol/server": "2.1.0",
     "cheerio": "1.2.0",