comfyui-mcp 0.49.3 → 0.49.4

package/dist/tools/vocabulary.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "comfyui-mcp",
-  "version": "0.49.3",
+  "version": "0.49.4",
   "mcpName": "io.github.artokun/comfyui-mcp",
   "description": "Local-first, agent-native control plane for ComfyUI — MCP server + autonomous sidebar agent that drives your live graph in natural language on ANY LLM: Claude/ChatGPT/Gemini on your subscription (no API key), free local models via Ollama (fully offline), or any hosted model via an OpenAI-compatible endpoint (DeepSeek, GLM, MiMo, OpenRouter). Generate images, video & audio, author and run workflows, manage models and custom nodes; a compact tool-router mode keeps even 4B models effective, and a built-in LLM Arena benchmarks them on real ComfyUI tasks. Also a Claude Code plugin with skills, slash commands, and installer packs. Local, LAN, VPS, or Comfy Cloud.",
   "homepage": "https://comfyui-mcp.artokun.io/docs",

package/scripts/gen-tool-docs.ts

@@ -25,6 +25,7 @@ import { fileURLToPath } from "node:url";
 import { z } from "zod";
 // zod 4 ships JSON Schema conversion natively (z.toJSONSchema) — no zod-to-json-schema.
 import { registerAllTools } from "../src/tools/index.js";
+import { TOOL_DOC_EXAMPLES, type ToolDocEntry } from "./tool-doc-examples.js";
 
 const __dirname = dirname(fileURLToPath(import.meta.url));
 const repoRoot = join(__dirname, "..");
@@ -351,6 +352,116 @@ function firstSentence(desc: string): string {
   return (m ? m[0] : desc).trim();
 }
 
+/**
+ * Validate every curated example in scripts/tool-doc-examples.ts against the
+ * tool's REAL zod schema, and fail generation if any of them is wrong.
+ *
+ * This exists because a documented call that does not typecheck is worse than no
+ * example at all: a reader copies it, it 400s, and they conclude the tool is
+ * broken. Prose cannot be unit-tested, so this is where examples get tested.
+ *
+ * Three distinct failures, each caught deliberately:
+ *
+ * 1. A key for a tool that no longer exists. During the consolidation tools are
+ *    being renamed and folded together; an example still keyed by a retired name
+ *    must become a loud failure, not a silently-ignored map entry.
+ *
+ * 2. A field that is not in the schema. zod objects STRIP unknown keys by
+ *    default, so `safeParse` alone happily accepts `{"filenmae": "x"}` and
+ *    reports success — the misspelling would ship. Hence the explicit key check
+ *    against the JSON Schema's properties, before parsing.
+ *
+ * 3. A field with the wrong type or a missing required one. That is what
+ *    `safeParse` is for, run against the same shape the MCP SDK advertises.
+ */
+function validateExamples(byName: Map<string, CapturedTool>): void {
+  const problems: string[] = [];
+
+  for (const [toolName, entry] of Object.entries(TOOL_DOC_EXAMPLES)) {
+    const tool = byName.get(toolName);
+    if (!tool) {
+      problems.push(
+        `${toolName}: no such tool is registered — it was probably renamed or ` +
+          `consolidated. Update or remove its entry in scripts/tool-doc-examples.ts.`,
+      );
+      continue;
+    }
+    const schema = z.object(tool.shape);
+    const json = z.toJSONSchema(schema, { reused: "inline", io: "input" }) as unknown as JsonSchema;
+    const known = new Set(Object.keys(json.properties ?? {}));
+
+    entry.examples.forEach((ex, i) => {
+      const where = `${toolName} example #${i + 1} ("${ex.ask}")`;
+      const unknownKeys = Object.keys(ex.args).filter((k) => !known.has(k));
+      if (unknownKeys.length > 0) {
+        problems.push(
+          `${where}: field(s) ${unknownKeys.map((k) => `\`${k}\``).join(", ")} ` +
+            `do not exist on this tool. Known fields: ${[...known].join(", ") || "(none)"}.`,
+        );
+        // Still parse below: a typo'd key is stripped, so the parse would pass
+        // and hide any OTHER problem in the same example.
+      }
+      const parsed = schema.safeParse(ex.args);
+      if (!parsed.success) {
+        const detail = parsed.error.issues
+          .map((iss) => `${iss.path.join(".") || "(root)"}: ${iss.message}`)
+          .join("; ");
+        problems.push(`${where}: does not satisfy the tool's schema — ${detail}`);
+      }
+    });
+  }
+
+  if (problems.length > 0) {
+    throw new Error(
+      `[gen-tool-docs] ${problems.length} documented example(s) do not match the live tool ` +
+        `schemas:\n  ${problems.join("\n  ")}\n` +
+        `Fix the example in scripts/tool-doc-examples.ts — do NOT relax this check. ` +
+        `An example that does not typecheck will be copied by a reader and will fail.`,
+    );
+  }
+}
+
+/** Render the curated examples for one tool, or the generated skeleton if it has none. */
+function renderExamples(t: CapturedTool, json: JsonSchema, entry?: ToolDocEntry): string[] {
+  const lines: string[] = [];
+
+  if (!entry || entry.examples.length === 0) {
+    lines.push("### Example", "");
+    lines.push(
+      "<Note>No worked example yet — the call below is a skeleton generated from the " +
+        "required parameters. Real examples live in `scripts/tool-doc-examples.ts`; " +
+        "contributions welcome.</Note>",
+      "",
+    );
+    lines.push(
+      "```json",
+      JSON.stringify({ tool: t.name, arguments: exampleArgs(t.name, json) }, null, 2),
+      "```",
+      "",
+    );
+    return lines;
+  }
+
+  lines.push(entry.examples.length === 1 ? "### Example" : "### Examples", "");
+  for (const ex of entry.examples) {
+    // The ASK comes first on purpose. The audience for this page mostly does not
+    // type JSON at anything — they say a sentence to an agent and it makes the
+    // call. Leading with the sentence shows which request reaches this tool;
+    // leading with the JSON implies a calling convention they will never use.
+    lines.push(`**You say:** ${esc(ex.ask)}`, "");
+    lines.push(
+      "```json",
+      JSON.stringify({ tool: t.name, arguments: ex.args }, null, 2),
+      "```",
+      "",
+    );
+    if (ex.argsNote) lines.push(`<Note>${esc(ex.argsNote)}</Note>`, "");
+    lines.push(`**You get back:** ${esc(ex.returns)}`, "");
+    if (ex.caution) lines.push(`<Warning>${esc(ex.caution)}</Warning>`, "");
+  }
+  return lines;
+}
+
 function renderTool(t: CapturedTool): string {
   // `io: "input"` matches what the MCP SDK advertises to clients
   // (sdk/server/zod-json-schema-compat.js defaults pipeStrategy to 'input').
@@ -371,10 +482,21 @@ function renderTool(t: CapturedTool): string {
   const required = new Set(json.required ?? []);
   const paramNames = Object.keys(props);
 
+  const entry = TOOL_DOC_EXAMPLES[t.name];
+
   const lines: string[] = [];
   lines.push(`## ${t.name}`, "");
   lines.push(esc(t.description), "");
 
+  // The gloss is ADDITIVE. The description above is written for model dispatch —
+  // it disambiguates this tool from its neighbours in the terms a model needs,
+  // which is why it talks about context cost and about which tool NOT to pick.
+  // Rewriting it for readability measurably degrades tool choice (#557/#654), so
+  // a human-facing sentence goes here, next to it, instead of over it.
+  if (entry?.gloss) {
+    lines.push(`<Tip>**In plain terms:** ${esc(entry.gloss)}</Tip>`, "");
+  }
+
   if (paramNames.length > 0) {
     lines.push("### Parameters", "");
     for (const name of paramNames) {
@@ -385,10 +507,7 @@ function renderTool(t: CapturedTool): string {
     lines.push("<Note>This tool takes no parameters.</Note>", "");
   }
 
-  lines.push("### Example", "");
-  lines.push("<Note>Example coming soon — the call below is a generated skeleton.</Note>", "");
-  const args = exampleArgs(t.name, json);
-  lines.push("```json", JSON.stringify({ tool: t.name, arguments: args }, null, 2), "```", "");
+  lines.push(...renderExamples(t, json, entry));
   lines.push("---", "");
   return lines.join("\n");
 }
@@ -408,6 +527,11 @@ async function main() {
   await registerAllTools(mockServer as never);
 
   const byName = new Map(captured.map((t) => [t.name, t]));
+
+  // Before ANY page is rendered — a bad example must abort the run, not be
+  // written into 16 files and then reported.
+  validateExamples(byName);
+
   const mapped = new Set<string>();
   mkdirSync(toolsDir, { recursive: true });
 
@@ -433,6 +557,16 @@ async function main() {
     page.push("");
     page.push(`<Info>${present.length} tool${present.length === 1 ? "" : "s"}. Generated from the live MCP tool schemas — do not edit by hand; run \`npm run docs:gen\`.</Info>`);
     page.push("");
+    // Every page carries this. The JSON below is what the AGENT sends; readers
+    // arriving from a search result were being shown a calling convention they
+    // will never type, with nothing on the page to say so.
+    page.push(
+      "<Tip>**You don't type these calls.** Ask your agent for what you want in " +
+        "ordinary English — it chooses the tool and fills in the arguments. The JSON " +
+        "on this page is what it sends. New here? Start with " +
+        "[Using the tools](/using-tools).</Tip>",
+    );
+    page.push("");
     for (const name of present) page.push(renderTool(byName.get(name)!));
 
     pending.push({ path: join(toolsDir, `${cat.slug}.mdx`), content: page.join("\n") });