UNPKG

comfyui-mcp

Version:

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),

257 lines • 11.4 kB
// Model-file extensions — kept in sync with workflow-validator.ts's isModel test. const MODEL_FILE_RE = /\.(safetensors|gguf|ckpt|pt|pth|bin|sft)$/i; // Hardcoded output classes, mirroring workflow-validator.ts step 4. const OUTPUT_CLASSES = new Set([ "SaveImage", "PreviewImage", "SaveAnimatedWEBP", "SaveAnimatedPNG", ]); /** * FL-MCP-style slot-name required heuristic, used ONLY for node classes absent * from object_info (uninstalled custom nodes). Returns the set of input-slot * names we *expect* a node of this class-name family to require, so a missing * key can be flagged. Returns null for families we can't reason about (a generic * unknown node), where guessing would only produce false positives. */ function heuristicRequiredSlots(classType) { if (/Sampler/i.test(classType)) { return ["model", "positive", "negative", "latent_image"]; } if (/VAE/i.test(classType)) { // Decode wants samples+vae; encode wants pixels/images+vae. `vae` is the // one slot common to the whole family, so that's all we assert. return ["vae"]; } // Loader / Load families are model-file consumers whose required input is a // widget (a *name*/*path*/*ckpt* value), not a link — handled separately below. return null; } /** Is a value an API-format connection tuple `[nodeId, outputIndex]`? */ function isConnection(value) { return (Array.isArray(value) && value.length === 2 && typeof value[0] === "string" && typeof value[1] === "number"); } function isOutputNode(classType, objectInfo) { return OUTPUT_CLASSES.has(classType) || objectInfo[classType]?.output_node === true; } /** * Analyze a workflow's structural health. Pure — no I/O, no fetch. * * @param workflow API-format workflow JSON. * @param objectInfo Node catalog from `/object_info` (authoritative required/optional). */ export function analyzeGraphHealth(workflow, objectInfo) { const nodeIds = Object.keys(workflow); const findings = []; // --- Node-type histogram ------------------------------------------------- const histogram = {}; for (const id of nodeIds) { const ct = workflow[id].class_type; histogram[ct] = (histogram[ct] ?? 0) + 1; } // --- Adjacency (forward: source -> [targets]) ---------------------------- const consumers = new Map(); // node -> nodes that read its output const sources = new Map(); // node -> nodes it reads from for (const id of nodeIds) { consumers.set(id, new Set()); sources.set(id, new Set()); } for (const id of nodeIds) { for (const value of Object.values(workflow[id].inputs)) { if (isConnection(value)) { const [srcId] = value; if (workflow[srcId] && srcId !== id) { sources.get(id).add(srcId); consumers.get(srcId).add(id); } } } } // --- 1. Disconnected nodes (warning) ------------------------------------- // No inbound links, no consumers, and not itself an output node. for (const id of nodeIds) { const ct = workflow[id].class_type; if (sources.get(id).size === 0 && consumers.get(id).size === 0 && !isOutputNode(ct, objectInfo)) { findings.push({ kind: "disconnected", severity: "warning", node_ids: [id], node_type: ct, detail: `Node ${id} (${ct}) has no connections — it is isolated and does nothing.`, }); } } // --- 2. Missing required inputs ------------------------------------------ for (const id of nodeIds) { const node = workflow[id]; const ct = node.class_type; const def = objectInfo[ct]; if (def) { // Authoritative: object_info required list. const required = def.input?.required ?? {}; for (const inputName of Object.keys(required)) { if (!(inputName in node.inputs)) { findings.push({ kind: "missing_required_input", severity: "warning", node_ids: [id], node_type: ct, detail: `Node ${id} (${ct}) is missing required input "${inputName}".`, }); } } } else { // Fallback heuristic — only for classes absent from object_info. const expected = heuristicRequiredSlots(ct); if (expected) { for (const inputName of expected) { if (!(inputName in node.inputs)) { findings.push({ kind: "missing_required_input", severity: "warning", node_ids: [id], node_type: ct, detail: `Node ${id} (${ct}) appears to be missing required input "${inputName}" (heuristic — "${ct}" is not installed here).`, heuristic: true, }); } } } } } // --- 3. Duplicate model loads (warning) ---------------------------------- // Group Loader/Load-family nodes by (class_type, model-file value). NUL can't // appear in a class_type or filename, so it is a collision-proof separator. const DUP_SEP = String.fromCharCode(0); const loadGroups = new Map(); for (const id of nodeIds) { const ct = workflow[id].class_type; if (!/Loader|Load/i.test(ct)) continue; for (const value of Object.values(workflow[id].inputs)) { if (typeof value === "string" && MODEL_FILE_RE.test(value)) { const key = `${ct}${DUP_SEP}${value}`; const arr = loadGroups.get(key) ?? []; arr.push(id); loadGroups.set(key, arr); } } } for (const [key, ids] of loadGroups) { if (ids.length < 2) continue; const [ct, file] = key.split(DUP_SEP); findings.push({ kind: "duplicate_model_load", severity: "warning", node_ids: ids, node_type: ct, detail: `${ct} loads "${file}" in nodes ${ids.join(", ")} — merge into one loader to save VRAM.`, }); } // --- 4. Orphaned branches (warning) -------------------------------------- // Reverse-BFS from every output node; unreached non-output nodes are computed // but never saved. Report one finding per connected component of the unreached // set (over the undirected graph) to avoid many line items on big graphs. const outputNodes = nodeIds.filter((id) => isOutputNode(workflow[id].class_type, objectInfo)); if (nodeIds.length > 0 && outputNodes.length === 0) { // No output node at all → ComfyUI rejects the prompt outright with "Prompt // has no outputs" (field: small models hand-build a graph and forget the // sink). Surface it as the top finding so validate/analyze catches it BEFORE // a failed run, and the agent can add the missing node instead of retrying. findings.push({ kind: "no_output_reachable", severity: "warning", node_ids: [], detail: "No output node — the workflow will FAIL to run (ComfyUI: \"Prompt has no outputs\"). " + "Add a terminal SaveImage (or PreviewImage / SaveVideo / SaveAudio) node and connect the final IMAGE/LATENT/etc. into it before running.", }); } if (outputNodes.length > 0) { const reachable = new Set(); const queue = [...outputNodes]; while (queue.length > 0) { const cur = queue.shift(); if (reachable.has(cur)) continue; reachable.add(cur); for (const src of sources.get(cur)) { if (!reachable.has(src)) queue.push(src); } } const unreached = nodeIds.filter((id) => !reachable.has(id) && !isOutputNode(workflow[id].class_type, objectInfo)); // Exclude fully-disconnected nodes already reported in check 1 — an isolated // node is its own story, not an orphaned branch. const unreachedSet = new Set(unreached.filter((id) => sources.get(id).size > 0 || consumers.get(id).size > 0)); // Undirected connected components within the unreached set. const visited = new Set(); for (const start of unreachedSet) { if (visited.has(start)) continue; const component = []; const stack = [start]; while (stack.length > 0) { const cur = stack.pop(); if (visited.has(cur)) continue; visited.add(cur); component.push(cur); for (const nb of [...sources.get(cur), ...consumers.get(cur)]) { if (unreachedSet.has(nb) && !visited.has(nb)) stack.push(nb); } } component.sort((a, b) => a.localeCompare(b)); const types = component.map((id) => workflow[id].class_type); findings.push({ kind: "orphaned_branch", severity: "warning", node_ids: component, detail: `Orphaned branch: nodes ${component.join(", ")} (${types.join(" → ")}) never reach a save/preview node.`, }); } } // --- 5. Muted / bypassed nodes (info) ------------------------------------ // Surfaced via _meta.mode where the raw API JSON carries it. convertUiToApi // *drops* mode-2/4 nodes, so for library workflows this is usually absent and // silently skipped; raw API JSON handed to validate_workflow is checked here. for (const id of nodeIds) { const mode = workflow[id]._meta?.mode; if (mode === "muted" || mode === "bypassed") { const ct = workflow[id].class_type; findings.push({ kind: "muted_or_bypassed", severity: "info", node_ids: [id], node_type: ct, detail: `Node ${id} (${ct}) is ${mode} (_meta.mode) — its connections are silently dropped.`, }); } } // --- Summary ------------------------------------------------------------- const typeCount = Object.keys(histogram).length; const top = Object.entries(histogram) .sort((a, b) => b[1] - a[1] || a[0].localeCompare(b[0])) .slice(0, 4) .map(([ct, n]) => `${ct} x${n}`) .join(", "); const warnCount = findings.filter((f) => f.severity === "warning").length; const infoCount = findings.filter((f) => f.severity === "info").length; const summary = `${nodeIds.length} nodes, ${typeCount} types` + (top ? ` (top: ${top})` : "") + ` — ${warnCount} warning(s), ${infoCount} info.`; return { total_nodes: nodeIds.length, node_type_histogram: histogram, findings, summary, }; } //# sourceMappingURL=workflow-health.js.map