comfyui-mcp 0.50.93 → 0.50.94

package/dist/boot.js

@@ -0,0 +1,392 @@
+#!/usr/bin/env node
+import { randomBytes } from "node:crypto";
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { ListPromptsRequestSchema, ListResourcesRequestSchema, ListResourceTemplatesRequestSchema, } from "@modelcontextprotocol/sdk/types.js";
+import { collectToolCatalog, registerFullTools } from "./tools/index.js";
+import { registerCompactTools } from "./tools/compact.js";
+import { tryInstallRetiredNameRedirect } from "./tools/retired-redirect.js";
+import { logger } from "./utils/logger.js";
+import { JobWatcher } from "./services/job-watcher.js";
+import { parseCliArgs, validateConnectUrl, exportExplicitToolMode } from "./transport/cli.js";
+import { startHttpServer } from "./transport/http.js";
+import { isLocalMode } from "./config.js";
+import { ensurePanelInstalled } from "./services/panel-installer.js";
+import { checkAndSelfUpdate } from "./services/self-update.js";
+/**
+ * Fire-and-forget: ensure the ComfyUI sidebar panel is installed (install-if-
+ * missing) on MCP load. LOCAL-only, hard-timed-out, and never throws — it must
+ * never block or crash startup. Opt out with COMFYUI_MCP_PANEL_AUTOINSTALL=0.
+ * The explicit `install_comfyui(action:'panel', panel_action:'update')` tool refreshes nightly on demand.
+ */
+function ensurePanelOnLoad() {
+    if (!isLocalMode())
+        return;
+    void ensurePanelInstalled()
+        .then((res) => {
+        switch (res.action) {
+            case "installed":
+                logger.info("Panel auto-install: installed the sidebar panel (nightly). RESTART ComfyUI to load it.", res);
+                break;
+            // #806 — "already present" is the whole claim. The line used to be paired
+            // with `action: "up-to-date"`, and users read the pair as "you are on the
+            // newest panel"; nothing on this path compares versions.
+            case "present":
+                logger.info("Panel auto-install: panel already present — NOT a version check. " +
+                    "Run install_comfyui(action:'panel', panel_action:'status') to compare it against what this build needs.", res);
+                break;
+            case "skipped-dev":
+                logger.info("Panel auto-install: skipped — dev install (symlink), managed manually.", res);
+                break;
+            case "skipped":
+                logger.debug("Panel auto-install: disabled via COMFYUI_MCP_PANEL_AUTOINSTALL.", res);
+                break;
+            case "shadowed":
+                logger.warn("Panel auto-install: a SHADOW copy in custom_nodes may be served instead of the real panel (#641). " +
+                    "Move the backup dir OUT of custom_nodes and hard-refresh the ComfyUI tab.", res);
+                break;
+            default:
+                logger.debug("Panel auto-install: unavailable.", res);
+        }
+    })
+        .catch(() => { });
+}
+/**
+ * Fire-and-forget: on MCP load, check the npm registry and (for global/local
+ * installs) auto-update the package on disk, then surface a "reconnect to load
+ * vX" note — the running process can't hot-swap its own code. NEVER updates a
+ * dev (npm link) install, hard-timed-out, and never throws. Opt out with
+ * COMFYUI_MCP_AUTOUPDATE=0. Mirrors the panel auto-install ensure pattern.
+ */
+function selfUpdateOnLoad() {
+    void checkAndSelfUpdate()
+        .then((res) => {
+        switch (res.action) {
+            case "updated":
+                logger.info(`Self-update: updated comfyui-mcp ${res.from} → ${res.to} (${res.mode}). ${res.note ?? ""}`, res);
+                break;
+            case "notify":
+                logger.info(`Self-update: ${res.note ?? `v${res.to} available.`}`, res);
+                break;
+            case "up-to-date":
+                logger.debug("Self-update: already on the latest version.", res);
+                break;
+            case "skipped-dev":
+                logger.info("Self-update: skipped — dev install (npm link / checkout).", res);
+                break;
+            case "skipped-disabled":
+                logger.debug("Self-update: disabled via COMFYUI_MCP_AUTOUPDATE.", res);
+                break;
+            default:
+                logger.debug("Self-update: unavailable.", res);
+        }
+    })
+        .catch(() => { });
+}
+async function createConfiguredServer(toolMode = "compact") {
+    const server = new McpServer({
+        name: "comfyui-mcp",
+        version: "0.1.0",
+    }, {
+        // We declare `resources` and `prompts` (with noop list handlers below)
+        // so federating clients like LiteLLM's MCP gateway, which probe every
+        // standard list endpoint on initialize fan-out, get a fast empty list
+        // instead of a per-server timeout from "Method not found". We don't
+        // expose resources or prompts today; advertising them is spec-correct
+        // when paired with a list handler that returns the empty set.
+        // Reported by @ductiletoaster in #29.
+        capabilities: {
+            tools: {},
+            resources: {},
+            prompts: {},
+        },
+    });
+    if (toolMode === "compact") {
+        // Compact tool mode (DEFAULT since #667): capture the whole tool surface
+        // into a catalog and expose only the list_tools/describe_tool/call_tool
+        // meta-tools, keeping the client's context cost near-zero until a tool is
+        // actually needed. Built for small/local LLMs (Hermes Agent, Ollama —
+        // issue #97), and the DEFAULT from #667 until 0.50.0, when it became the
+        // OPT-IN: the reason it was default was that the direct surface cost
+        // ~200KB (~50k tokens) per tools/list at 154 tools, and consolidation took
+        // that to 37. Reach for `--compact` when the client's context is the
+        // binding constraint — a small local model, or a harness that re-injects
+        // tools/list on every read.
+        const catalog = await collectToolCatalog();
+        registerCompactTools(server, catalog);
+        logger.info(`Compact tool mode: ${catalog.tools.size} tools available via list_tools/describe_tool/call_tool`);
+    }
+    else {
+        // Full direct surface (opt-in via --full) PLUS the compact facade
+        // (list_tools/describe_tool/call_tool) as a stable reconnect escape hatch —
+        // see registerFullTools and issue #616. One atomic registration pass,
+        // completed before the transport connects below. Opt out of the facade
+        // with COMFYUI_MCP_NO_FACADE=1.
+        await registerFullTools(server);
+    }
+    // Serve the retirement ledger on the DIRECT tools/call path too, not only through
+    // the call_tool facade — see src/tools/retired-redirect.ts. Installed here, after
+    // BOTH branches, because both need it and for different reasons:
+    //
+    //  - full mode is the one the 0.50.0 flip (#726) makes the default, where 121
+    //    retired names would otherwise answer with a bare "Tool X not found";
+    //  - compact mode advertises only the 3 meta-tools, so a client calling a retired
+    //    name DIRECTLY is exactly the stale-snapshot client the facade exists for (#616)
+    //    — it holds a cached binding for a name this surface no longer lists, and the
+    //    ledger is the only thing that can tell it where the capability went.
+    //
+    // Additive: a registered name, and any name the ledger does not know, dispatches
+    // through the SDK unchanged. Deliberately BEFORE server.connect() (the callers
+    // below connect the returned server), so no request can arrive mid-swap.
+    //
+    // The result is REPORTED rather than discarded. If it is false the server still
+    // boots (see tryInstallRetiredNameRedirect for why bricking startup is the worse
+    // failure), but "boots normally while silently answering 121 retired names with a
+    // bare 404" is exactly the shape of failure this whole change exists to remove — so
+    // it is stated on the same startup line an operator already reads to confirm the
+    // surface came up, not left as one error line among registration noise.
+    //
+    // Residual risk, stated plainly rather than papered over: nothing here can make the
+    // degraded state visible to the CALLER, because the wrapper is the only thing that
+    // could have changed what the caller sees. What actually holds the guarantee is the
+    // `~1.29.0` cap on `@modelcontextprotocol/sdk` in package.json — this is normally run
+    // as `npx comfyui-mcp`, which resolves fresh, so an open range would have let a user
+    // silently pick up internals nothing ever ran against.
+    const redirects = await tryInstallRetiredNameRedirect(server);
+    logger.info(`Tool mode: ${toolMode}. Retired-name redirects on direct tools/call: ` +
+        (redirects
+            ? "active"
+            : "INACTIVE — a call to a name removed in an earlier release will 404 without naming its replacement"));
+    server.server.setRequestHandler(ListResourcesRequestSchema, async () => ({
+        resources: [],
+    }));
+    server.server.setRequestHandler(ListResourceTemplatesRequestSchema, async () => ({ resourceTemplates: [] }));
+    server.server.setRequestHandler(ListPromptsRequestSchema, async () => ({
+        prompts: [],
+    }));
+    return server;
+}
+/**
+ * Open a cloudflared quick tunnel to the local HTTP MCP port and print a clear,
+ * ready-to-paste Claude Desktop Custom Connector block (public https://…/mcp
+ * URL + token + headless X-API-Key usage). Resilient: a missing cloudflared
+ * binary (or any tunnel error) surfaces install guidance and leaves the local
+ * server running instead of crashing.
+ */
+async function openTunnelAndAnnounce(host, port, token) {
+    const { startQuickTunnel } = await import("./services/tunnel.js");
+    logger.info("[tunnel] starting cloudflared quick tunnel…");
+    let publicUrl;
+    try {
+        const tunnel = await startQuickTunnel(port);
+        publicUrl = tunnel.url;
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        logger.error(`[tunnel] could not start cloudflared: ${message}\n` +
+            `  Install it, then re-run with --tunnel:\n` +
+            `    npm install -g cloudflared      # or: brew install cloudflared / winget install cloudflare.cloudflared\n` +
+            `  The local server is still running at http://${host}:${port}/mcp (token auth active).`);
+        return;
+    }
+    const mcpUrl = `${publicUrl}/mcp`;
+    const snippet = JSON.stringify({
+        mcpServers: {
+            comfyui: {
+                url: mcpUrl,
+                headers: { "X-API-Key": token },
+            },
+        },
+    }, null, 2);
+    // Single multi-line block to stderr so it survives MCP stdio framing and is
+    // easy to copy from the terminal.
+    process.stderr.write([
+        "",
+        "════════════════════════════════════════════════════════════════════",
+        " ComfyUI MCP — Remote / Hosted Connector is LIVE",
+        "════════════════════════════════════════════════════════════════════",
+        ` Public MCP URL : ${mcpUrl}`,
+        ` Auth token     : ${token}`,
+        "",
+        " Claude Desktop → Settings → Connectors → Add custom connector:",
+        `   • Name : ComfyUI`,
+        `   • URL  : ${mcpUrl}`,
+        `   • Header: X-API-Key: ${token}   (or Authorization: Bearer ${token})`,
+        "",
+        " Headless / programmatic config snippet:",
+        snippet,
+        "",
+        " Keep this terminal open — the tunnel closes when the process exits.",
+        "════════════════════════════════════════════════════════════════════",
+        "",
+    ].join("\n"));
+}
+/** A remote (non-loopback) ComfyUI served over https — the case where the pod's
+ *  browser panel needs the secure wss:// bridge instead of plain ws://. */
+function isRemoteHttpsPod(u) {
+    try {
+        const url = new URL(u);
+        const h = url.hostname.toLowerCase();
+        return (url.protocol === "https:" &&
+            !["127.0.0.1", "localhost", "::1", "0.0.0.0", ""].includes(h));
+    }
+    catch {
+        return false;
+    }
+}
+async function main() {
+    const cli = parseCliArgs(process.argv);
+    // `--help` / `-h`: print usage and exit BEFORE anything else. It must precede
+    // every other branch — including `setup` and `connect` — because a user who
+    // asks for help has by definition not decided what to run yet, and starting a
+    // server or writing a harness config in response to a help request is doing
+    // something they did not ask for. Exits 0: asking for help is not an error.
+    //
+    // stdout, not stderr: this is the requested output, and a user piping it to a
+    // pager or grep should get it on the stream that carries results.
+    if (cli.help) {
+        const { renderCliHelp } = await import("./transport/cli.js");
+        process.stdout.write(renderCliHelp());
+        return;
+    }
+    // `setup <agent>`: write the comfyui MCP entry into a non-Claude harness's
+    // config (Hermes Agent / OpenClaw / Copilot CLI — issue #97), print next
+    // steps, and exit. Never starts the MCP server.
+    if (cli.setupAgent !== undefined) {
+        const { setupAgent, AGENT_NAMES } = await import("./services/agent-setup.js");
+        const agent = cli.setupAgent;
+        if (!AGENT_NAMES.includes(agent)) {
+            process.stderr.write(`\nUsage: comfyui-mcp setup <${AGENT_NAMES.join("|")}> [--compact|--full] [--comfyui-url <url>] [--dry-run]\n` +
+                (cli.setupAgent ? `\nUnknown agent "${cli.setupAgent}".\n` : "") +
+                `\nWrites the comfyui MCP server entry into the agent's own config file.\n`);
+            process.exit(1);
+        }
+        try {
+            const result = await setupAgent({
+                agent,
+                compact: cli.toolModeExplicit ? cli.toolMode === "compact" : undefined,
+                comfyuiUrl: cli.comfyuiUrl,
+                dryRun: cli.setupDryRun,
+            });
+            const lines = [
+                "",
+                result.wrote
+                    ? `✓ Added the "comfyui" MCP server to ${result.configPath}`
+                    : `— dry run: would write ${result.configPath} as —`,
+                ...(result.wrote ? [] : ["", result.content.trimEnd()]),
+                "",
+                "Next steps:",
+                ...result.nextSteps.map((s) => `  • ${s}`),
+                "",
+            ];
+            process.stdout.write(lines.join("\n"));
+            process.exit(0);
+        }
+        catch (err) {
+            process.stderr.write(`\ncomfyui-mcp setup failed: ${err instanceof Error ? err.message : err}\n`);
+            process.exit(1);
+        }
+    }
+    // Standalone background orchestrator: owns the UI bridge and drives the panel
+    // with autonomous Agent SDK sessions. Not an MCP server — it never returns.
+    if (cli.panelOrchestrator) {
+        // `connect <comfyui-url>`: drive a (possibly REMOTE) ComfyUI from an agent on
+        // THIS machine. Export the URL as COMFYUI_URL so the orchestrator and the
+        // comfyui MCP it spawns target that server — the same remote-URL mechanism the
+        // panel's "Remote ComfyUI URL" setting uses, just from the CLI. For a REMOTE
+        // https pod the orchestrator auto-opens a secure wss:// Cloudflare tunnel so
+        // the pod's HTTPS panel can reach the bridge (a plain ws:// from https is
+        // browser-blocked); --insecure-bridge forces the plain loopback bridge.
+        if (cli.insecureBridge)
+            process.env.COMFYUI_MCP_INSECURE_BRIDGE = "1";
+        // #667: an explicit --full/--compact must reach the orchestrator's spawned
+        // MCP children, which read the mode from the ENV — the flag alone never
+        // made it downstream, silently running compact when full was requested.
+        exportExplicitToolMode(cli);
+        if (cli.comfyuiUrl) {
+            // Hard-fail on a bad `connect <url>` instead of silently falling back to the
+            // local ComfyUI (which would make the banner below lie about what it drives).
+            const urlError = validateConnectUrl(cli.comfyuiUrl);
+            if (urlError) {
+                process.stderr.write(`\nComfyUI MCP — cannot start: ${urlError}\n\n`);
+                process.exit(1);
+            }
+            process.env.COMFYUI_URL = cli.comfyuiUrl;
+            // Default panel bridge port is 9180 (one port shared by all providers);
+            // COMFYUI_MCP_BRIDGE_PORT overrides.
+            const bridgePort = Number(process.env.COMFYUI_MCP_BRIDGE_PORT) || 9180;
+            // Remote https pod → secure wss:// tunnel (auto); local/http or
+            // --insecure-bridge → plain loopback ws://. Informational only here.
+            const secureBridge = !cli.insecureBridge && isRemoteHttpsPod(cli.comfyuiUrl);
+            const bridgeLine = secureBridge
+                ? " Agent bridge : wss:// secure Cloudflare tunnel (auto — nothing to copy)"
+                : ` Agent bridge : ws://127.0.0.1:${bridgePort}`;
+            process.stderr.write([
+                "",
+                "════════════════════════════════════════════════════════════════════",
+                " ComfyUI MCP — local agent bridge is starting",
+                "════════════════════════════════════════════════════════════════════",
+                bridgeLine,
+                ` Driving      : ${cli.comfyuiUrl}`,
+                secureBridge
+                    ? " Secure       : the pod's HTTPS panel connects automatically over an\n                encrypted tunnel — no URL to paste, works in any browser."
+                    : null,
+                "",
+                " Next steps:",
+                `   1. Open that ComfyUI in your browser: ${cli.comfyuiUrl}`,
+                "   2. In the Agent panel's Settings → General, turn ON",
+                "      'Use external/local orchestrator (advanced)'.",
+                "   3. Click Connect in the panel (the Agent panel's Connect dropdown).",
+                "",
+                " Until you click Connect this window stays quiet — that's expected, not",
+                " a hang. The agent runs HERE on your Claude/Codex login; nothing is",
+                " installed on the ComfyUI box. Keep this terminal open.",
+                "════════════════════════════════════════════════════════════════════",
+                "",
+            ]
+                .filter((l) => l !== null)
+                .join("\n"));
+        }
+        const { runPanelOrchestrator } = await import("./orchestrator/index.js");
+        await runPanelOrchestrator();
+        return;
+    }
+    await JobWatcher.cleanupOldFiles();
+    if (cli.transport === "http") {
+        // In tunnel mode, require a token even if none was configured: the endpoint
+        // is about to be exposed publicly, so generate a strong one on the fly.
+        const token = cli.token ?? (cli.tunnel ? randomBytes(24).toString("hex") : undefined);
+        await startHttpServer({
+            host: cli.host,
+            port: cli.port,
+            token,
+            allowUnauthenticated: cli.allowUnauthenticated,
+            createServer: () => createConfiguredServer(cli.toolMode),
+        });
+        logger.info(`ComfyUI MCP server running on http://${cli.host}:${cli.port}/mcp`);
+        if (token) {
+            logger.info(`HTTP MCP auth ENABLED — send 'Authorization: Bearer <token>' or 'X-API-Key: <token>'.`);
+        }
+        if (cli.tunnel) {
+            await openTunnelAndAnnounce(cli.host, cli.port, token);
+        }
+    }
+    else {
+        const server = await createConfiguredServer(cli.toolMode);
+        const transport = new StdioServerTransport();
+        await server.connect(transport);
+        logger.info("ComfyUI MCP server running on stdio");
+    }
+    // After the server is up: auto-ensure the sidebar panel (non-blocking).
+    ensurePanelOnLoad();
+    // ...and self-check the npm registry for a newer published version (non-blocking).
+    selfUpdateOnLoad();
+}
+main().catch((err) => {
+    // Error instances JSON-serialize to {} — log the message/stack explicitly so
+    // a startup failure (e.g. the unauthenticated-non-loopback guard in Docker)
+    // is actually debuggable from the console output.
+    logger.error(`Fatal error: ${err instanceof Error ? (err.stack ?? err.message) : String(err)}`);
+    process.exit(1);
+});
+//# sourceMappingURL=boot.js.map

package/dist/boot.js.map

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

package/dist/experimental/run.js

@@ -4,7 +4,7 @@ import { maybeStartAgentPoc } from "./agent-poc.js";
 // ---------------------------------------------------------------------------
 // Standalone runner for the experimental embedded-agent-panel POC.
 //
-// This is intentionally NOT imported by src/index.ts — the default MCP server
+// This is intentionally NOT imported by src/boot.ts — the default MCP server
 // (stdio / HTTP) never touches the POC. Run it explicitly, e.g.:
 //
 //   COMFYUI_MCP_AGENT_POC=1 ANTHROPIC_API_KEY=... npx tsx src/experimental/run.ts

package/dist/experimental/run.js.map

@@ -1 +1 @@
-{"version":3,"file":"run.js","sourceRoot":"","sources":["../../src/experimental/run.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAC5C,OAAO,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAEpD,8EAA8E;AAC9E,mEAAmE;AACnE,EAAE;AACF,8EAA8E;AAC9E,iEAAiE;AACjE,EAAE;AACF,kFAAkF;AAClF,yFAAyF;AACzF,8EAA8E;AAE9E,KAAK,UAAU,IAAI;IACjB,MAAM,MAAM,GAAG,MAAM,kBAAkB,EAAE,CAAC;IAC1C,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,CAAC,IAAI,CACT,8FAA8F,CAC/F,CAAC;QACF,OAAO;IACT,CAAC;IAED,MAAM,CAAC,IAAI,CAAC,wBAAwB,MAAM,CAAC,QAAQ,WAAW,CAAC,CAAC;IAChE,IAAI,MAAM,CAAC,SAAS,EAAE,CAAC;QACrB,MAAM,CAAC,IAAI,CAAC,2BAA2B,MAAM,CAAC,SAAS,EAAE,CAAC,CAAC;IAC7D,CAAC;IAED,MAAM,QAAQ,GAAG,GAAS,EAAE;QAC1B,MAAM,CAAC,IAAI,CAAC,8BAA8B,CAAC,CAAC;QAC5C,KAAK,MAAM,CAAC,IAAI,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;IACjD,CAAC,CAAC;IACF,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;IAC/B,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;AAClC,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;IACnB,MAAM,CAAC,KAAK,CAAC,yBAAyB,EAAE,GAAG,CAAC,CAAC;IAC7C,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}
+{"version":3,"file":"run.js","sourceRoot":"","sources":["../../src/experimental/run.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAC5C,OAAO,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAEpD,8EAA8E;AAC9E,mEAAmE;AACnE,EAAE;AACF,6EAA6E;AAC7E,iEAAiE;AACjE,EAAE;AACF,kFAAkF;AAClF,yFAAyF;AACzF,8EAA8E;AAE9E,KAAK,UAAU,IAAI;IACjB,MAAM,MAAM,GAAG,MAAM,kBAAkB,EAAE,CAAC;IAC1C,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,CAAC,IAAI,CACT,8FAA8F,CAC/F,CAAC;QACF,OAAO;IACT,CAAC;IAED,MAAM,CAAC,IAAI,CAAC,wBAAwB,MAAM,CAAC,QAAQ,WAAW,CAAC,CAAC;IAChE,IAAI,MAAM,CAAC,SAAS,EAAE,CAAC;QACrB,MAAM,CAAC,IAAI,CAAC,2BAA2B,MAAM,CAAC,SAAS,EAAE,CAAC,CAAC;IAC7D,CAAC;IAED,MAAM,QAAQ,GAAG,GAAS,EAAE;QAC1B,MAAM,CAAC,IAAI,CAAC,8BAA8B,CAAC,CAAC;QAC5C,KAAK,MAAM,CAAC,IAAI,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;IACjD,CAAC,CAAC;IACF,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;IAC/B,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;AAClC,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;IACnB,MAAM,CAAC,KAAK,CAAC,yBAAyB,EAAE,GAAG,CAAC,CAAC;IAC7C,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/index.js

@@ -1,392 +1,29 @@
 #!/usr/bin/env node
-import { randomBytes } from "node:crypto";
-import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
-import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
-import { ListPromptsRequestSchema, ListResourcesRequestSchema, ListResourceTemplatesRequestSchema, } from "@modelcontextprotocol/sdk/types.js";
-import { collectToolCatalog, registerFullTools } from "./tools/index.js";
-import { registerCompactTools } from "./tools/compact.js";
-import { tryInstallRetiredNameRedirect } from "./tools/retired-redirect.js";
-import { logger } from "./utils/logger.js";
-import { JobWatcher } from "./services/job-watcher.js";
-import { parseCliArgs, validateConnectUrl, exportExplicitToolMode } from "./transport/cli.js";
-import { startHttpServer } from "./transport/http.js";
-import { isLocalMode } from "./config.js";
-import { ensurePanelInstalled } from "./services/panel-installer.js";
-import { checkAndSelfUpdate } from "./services/self-update.js";
-/**
- * Fire-and-forget: ensure the ComfyUI sidebar panel is installed (install-if-
- * missing) on MCP load. LOCAL-only, hard-timed-out, and never throws — it must
- * never block or crash startup. Opt out with COMFYUI_MCP_PANEL_AUTOINSTALL=0.
- * The explicit `install_comfyui(action:'panel', panel_action:'update')` tool refreshes nightly on demand.
- */
-function ensurePanelOnLoad() {
-    if (!isLocalMode())
-        return;
-    void ensurePanelInstalled()
-        .then((res) => {
-        switch (res.action) {
-            case "installed":
-                logger.info("Panel auto-install: installed the sidebar panel (nightly). RESTART ComfyUI to load it.", res);
-                break;
-            // #806 — "already present" is the whole claim. The line used to be paired
-            // with `action: "up-to-date"`, and users read the pair as "you are on the
-            // newest panel"; nothing on this path compares versions.
-            case "present":
-                logger.info("Panel auto-install: panel already present — NOT a version check. " +
-                    "Run install_comfyui(action:'panel', panel_action:'status') to compare it against what this build needs.", res);
-                break;
-            case "skipped-dev":
-                logger.info("Panel auto-install: skipped — dev install (symlink), managed manually.", res);
-                break;
-            case "skipped":
-                logger.debug("Panel auto-install: disabled via COMFYUI_MCP_PANEL_AUTOINSTALL.", res);
-                break;
-            case "shadowed":
-                logger.warn("Panel auto-install: a SHADOW copy in custom_nodes may be served instead of the real panel (#641). " +
-                    "Move the backup dir OUT of custom_nodes and hard-refresh the ComfyUI tab.", res);
-                break;
-            default:
-                logger.debug("Panel auto-install: unavailable.", res);
-        }
-    })
-        .catch(() => { });
+// #1318 — THE LAUNCHER EXISTS SO A DAMAGED INSTALL CAN SAY SO.
+//
+// Everything this program does lives in ./boot.js. It is loaded DYNAMICALLY, and
+// that is the whole point: a static import of a missing dependency throws before
+// any of our code runs, so the user gets Node's resolver talking about a path
+// inside node_modules and nothing else. That is what happened in #1318 — a global
+// install whose `@modelcontextprotocol/sdk` was half-extracted produced an
+// ERR_MODULE_NOT_FOUND that never mentioned comfyui-mcp, while the recorded
+// version still read as current.
+//
+// Keeping this file free of package imports is load-bearing. Anything imported
+// here statically is something that can fail before the handler is installed, and
+// the handler is the only reason this file exists.
+import { describeBrokenInstall, isModuleResolutionFailure } from "./utils/broken-install.js";
+try {
+    await import("./boot.js");
 }
-/**
- * Fire-and-forget: on MCP load, check the npm registry and (for global/local
- * installs) auto-update the package on disk, then surface a "reconnect to load
- * vX" note — the running process can't hot-swap its own code. NEVER updates a
- * dev (npm link) install, hard-timed-out, and never throws. Opt out with
- * COMFYUI_MCP_AUTOUPDATE=0. Mirrors the panel auto-install ensure pattern.
- */
-function selfUpdateOnLoad() {
-    void checkAndSelfUpdate()
-        .then((res) => {
-        switch (res.action) {
-            case "updated":
-                logger.info(`Self-update: updated comfyui-mcp ${res.from} → ${res.to} (${res.mode}). ${res.note ?? ""}`, res);
-                break;
-            case "notify":
-                logger.info(`Self-update: ${res.note ?? `v${res.to} available.`}`, res);
-                break;
-            case "up-to-date":
-                logger.debug("Self-update: already on the latest version.", res);
-                break;
-            case "skipped-dev":
-                logger.info("Self-update: skipped — dev install (npm link / checkout).", res);
-                break;
-            case "skipped-disabled":
-                logger.debug("Self-update: disabled via COMFYUI_MCP_AUTOUPDATE.", res);
-                break;
-            default:
-                logger.debug("Self-update: unavailable.", res);
-        }
-    })
-        .catch(() => { });
-}
-async function createConfiguredServer(toolMode = "compact") {
-    const server = new McpServer({
-        name: "comfyui-mcp",
-        version: "0.1.0",
-    }, {
-        // We declare `resources` and `prompts` (with noop list handlers below)
-        // so federating clients like LiteLLM's MCP gateway, which probe every
-        // standard list endpoint on initialize fan-out, get a fast empty list
-        // instead of a per-server timeout from "Method not found". We don't
-        // expose resources or prompts today; advertising them is spec-correct
-        // when paired with a list handler that returns the empty set.
-        // Reported by @ductiletoaster in #29.
-        capabilities: {
-            tools: {},
-            resources: {},
-            prompts: {},
-        },
-    });
-    if (toolMode === "compact") {
-        // Compact tool mode (DEFAULT since #667): capture the whole tool surface
-        // into a catalog and expose only the list_tools/describe_tool/call_tool
-        // meta-tools, keeping the client's context cost near-zero until a tool is
-        // actually needed. Built for small/local LLMs (Hermes Agent, Ollama —
-        // issue #97), and the DEFAULT from #667 until 0.50.0, when it became the
-        // OPT-IN: the reason it was default was that the direct surface cost
-        // ~200KB (~50k tokens) per tools/list at 154 tools, and consolidation took
-        // that to 37. Reach for `--compact` when the client's context is the
-        // binding constraint — a small local model, or a harness that re-injects
-        // tools/list on every read.
-        const catalog = await collectToolCatalog();
-        registerCompactTools(server, catalog);
-        logger.info(`Compact tool mode: ${catalog.tools.size} tools available via list_tools/describe_tool/call_tool`);
-    }
-    else {
-        // Full direct surface (opt-in via --full) PLUS the compact facade
-        // (list_tools/describe_tool/call_tool) as a stable reconnect escape hatch —
-        // see registerFullTools and issue #616. One atomic registration pass,
-        // completed before the transport connects below. Opt out of the facade
-        // with COMFYUI_MCP_NO_FACADE=1.
-        await registerFullTools(server);
-    }
-    // Serve the retirement ledger on the DIRECT tools/call path too, not only through
-    // the call_tool facade — see src/tools/retired-redirect.ts. Installed here, after
-    // BOTH branches, because both need it and for different reasons:
-    //
-    //  - full mode is the one the 0.50.0 flip (#726) makes the default, where 121
-    //    retired names would otherwise answer with a bare "Tool X not found";
-    //  - compact mode advertises only the 3 meta-tools, so a client calling a retired
-    //    name DIRECTLY is exactly the stale-snapshot client the facade exists for (#616)
-    //    — it holds a cached binding for a name this surface no longer lists, and the
-    //    ledger is the only thing that can tell it where the capability went.
-    //
-    // Additive: a registered name, and any name the ledger does not know, dispatches
-    // through the SDK unchanged. Deliberately BEFORE server.connect() (the callers
-    // below connect the returned server), so no request can arrive mid-swap.
-    //
-    // The result is REPORTED rather than discarded. If it is false the server still
-    // boots (see tryInstallRetiredNameRedirect for why bricking startup is the worse
-    // failure), but "boots normally while silently answering 121 retired names with a
-    // bare 404" is exactly the shape of failure this whole change exists to remove — so
-    // it is stated on the same startup line an operator already reads to confirm the
-    // surface came up, not left as one error line among registration noise.
-    //
-    // Residual risk, stated plainly rather than papered over: nothing here can make the
-    // degraded state visible to the CALLER, because the wrapper is the only thing that
-    // could have changed what the caller sees. What actually holds the guarantee is the
-    // `~1.29.0` cap on `@modelcontextprotocol/sdk` in package.json — this is normally run
-    // as `npx comfyui-mcp`, which resolves fresh, so an open range would have let a user
-    // silently pick up internals nothing ever ran against.
-    const redirects = await tryInstallRetiredNameRedirect(server);
-    logger.info(`Tool mode: ${toolMode}. Retired-name redirects on direct tools/call: ` +
-        (redirects
-            ? "active"
-            : "INACTIVE — a call to a name removed in an earlier release will 404 without naming its replacement"));
-    server.server.setRequestHandler(ListResourcesRequestSchema, async () => ({
-        resources: [],
-    }));
-    server.server.setRequestHandler(ListResourceTemplatesRequestSchema, async () => ({ resourceTemplates: [] }));
-    server.server.setRequestHandler(ListPromptsRequestSchema, async () => ({
-        prompts: [],
-    }));
-    return server;
-}
-/**
- * Open a cloudflared quick tunnel to the local HTTP MCP port and print a clear,
- * ready-to-paste Claude Desktop Custom Connector block (public https://…/mcp
- * URL + token + headless X-API-Key usage). Resilient: a missing cloudflared
- * binary (or any tunnel error) surfaces install guidance and leaves the local
- * server running instead of crashing.
- */
-async function openTunnelAndAnnounce(host, port, token) {
-    const { startQuickTunnel } = await import("./services/tunnel.js");
-    logger.info("[tunnel] starting cloudflared quick tunnel…");
-    let publicUrl;
-    try {
-        const tunnel = await startQuickTunnel(port);
-        publicUrl = tunnel.url;
-    }
-    catch (err) {
-        const message = err instanceof Error ? err.message : String(err);
-        logger.error(`[tunnel] could not start cloudflared: ${message}\n` +
-            `  Install it, then re-run with --tunnel:\n` +
-            `    npm install -g cloudflared      # or: brew install cloudflared / winget install cloudflare.cloudflared\n` +
-            `  The local server is still running at http://${host}:${port}/mcp (token auth active).`);
-        return;
-    }
-    const mcpUrl = `${publicUrl}/mcp`;
-    const snippet = JSON.stringify({
-        mcpServers: {
-            comfyui: {
-                url: mcpUrl,
-                headers: { "X-API-Key": token },
-            },
-        },
-    }, null, 2);
-    // Single multi-line block to stderr so it survives MCP stdio framing and is
-    // easy to copy from the terminal.
-    process.stderr.write([
-        "",
-        "════════════════════════════════════════════════════════════════════",
-        " ComfyUI MCP — Remote / Hosted Connector is LIVE",
-        "════════════════════════════════════════════════════════════════════",
-        ` Public MCP URL : ${mcpUrl}`,
-        ` Auth token     : ${token}`,
-        "",
-        " Claude Desktop → Settings → Connectors → Add custom connector:",
-        `   • Name : ComfyUI`,
-        `   • URL  : ${mcpUrl}`,
-        `   • Header: X-API-Key: ${token}   (or Authorization: Bearer ${token})`,
-        "",
-        " Headless / programmatic config snippet:",
-        snippet,
-        "",
-        " Keep this terminal open — the tunnel closes when the process exits.",
-        "════════════════════════════════════════════════════════════════════",
-        "",
-    ].join("\n"));
-}
-/** A remote (non-loopback) ComfyUI served over https — the case where the pod's
- *  browser panel needs the secure wss:// bridge instead of plain ws://. */
-function isRemoteHttpsPod(u) {
-    try {
-        const url = new URL(u);
-        const h = url.hostname.toLowerCase();
-        return (url.protocol === "https:" &&
-            !["127.0.0.1", "localhost", "::1", "0.0.0.0", ""].includes(h));
-    }
-    catch {
-        return false;
-    }
-}
-async function main() {
-    const cli = parseCliArgs(process.argv);
-    // `--help` / `-h`: print usage and exit BEFORE anything else. It must precede
-    // every other branch — including `setup` and `connect` — because a user who
-    // asks for help has by definition not decided what to run yet, and starting a
-    // server or writing a harness config in response to a help request is doing
-    // something they did not ask for. Exits 0: asking for help is not an error.
-    //
-    // stdout, not stderr: this is the requested output, and a user piping it to a
-    // pager or grep should get it on the stream that carries results.
-    if (cli.help) {
-        const { renderCliHelp } = await import("./transport/cli.js");
-        process.stdout.write(renderCliHelp());
-        return;
-    }
-    // `setup <agent>`: write the comfyui MCP entry into a non-Claude harness's
-    // config (Hermes Agent / OpenClaw / Copilot CLI — issue #97), print next
-    // steps, and exit. Never starts the MCP server.
-    if (cli.setupAgent !== undefined) {
-        const { setupAgent, AGENT_NAMES } = await import("./services/agent-setup.js");
-        const agent = cli.setupAgent;
-        if (!AGENT_NAMES.includes(agent)) {
-            process.stderr.write(`\nUsage: comfyui-mcp setup <${AGENT_NAMES.join("|")}> [--compact|--full] [--comfyui-url <url>] [--dry-run]\n` +
-                (cli.setupAgent ? `\nUnknown agent "${cli.setupAgent}".\n` : "") +
-                `\nWrites the comfyui MCP server entry into the agent's own config file.\n`);
-            process.exit(1);
-        }
-        try {
-            const result = await setupAgent({
-                agent,
-                compact: cli.toolModeExplicit ? cli.toolMode === "compact" : undefined,
-                comfyuiUrl: cli.comfyuiUrl,
-                dryRun: cli.setupDryRun,
-            });
-            const lines = [
-                "",
-                result.wrote
-                    ? `✓ Added the "comfyui" MCP server to ${result.configPath}`
-                    : `— dry run: would write ${result.configPath} as —`,
-                ...(result.wrote ? [] : ["", result.content.trimEnd()]),
-                "",
-                "Next steps:",
-                ...result.nextSteps.map((s) => `  • ${s}`),
-                "",
-            ];
-            process.stdout.write(lines.join("\n"));
-            process.exit(0);
-        }
-        catch (err) {
-            process.stderr.write(`\ncomfyui-mcp setup failed: ${err instanceof Error ? err.message : err}\n`);
-            process.exit(1);
-        }
-    }
-    // Standalone background orchestrator: owns the UI bridge and drives the panel
-    // with autonomous Agent SDK sessions. Not an MCP server — it never returns.
-    if (cli.panelOrchestrator) {
-        // `connect <comfyui-url>`: drive a (possibly REMOTE) ComfyUI from an agent on
-        // THIS machine. Export the URL as COMFYUI_URL so the orchestrator and the
-        // comfyui MCP it spawns target that server — the same remote-URL mechanism the
-        // panel's "Remote ComfyUI URL" setting uses, just from the CLI. For a REMOTE
-        // https pod the orchestrator auto-opens a secure wss:// Cloudflare tunnel so
-        // the pod's HTTPS panel can reach the bridge (a plain ws:// from https is
-        // browser-blocked); --insecure-bridge forces the plain loopback bridge.
-        if (cli.insecureBridge)
-            process.env.COMFYUI_MCP_INSECURE_BRIDGE = "1";
-        // #667: an explicit --full/--compact must reach the orchestrator's spawned
-        // MCP children, which read the mode from the ENV — the flag alone never
-        // made it downstream, silently running compact when full was requested.
-        exportExplicitToolMode(cli);
-        if (cli.comfyuiUrl) {
-            // Hard-fail on a bad `connect <url>` instead of silently falling back to the
-            // local ComfyUI (which would make the banner below lie about what it drives).
-            const urlError = validateConnectUrl(cli.comfyuiUrl);
-            if (urlError) {
-                process.stderr.write(`\nComfyUI MCP — cannot start: ${urlError}\n\n`);
-                process.exit(1);
-            }
-            process.env.COMFYUI_URL = cli.comfyuiUrl;
-            // Default panel bridge port is 9180 (one port shared by all providers);
-            // COMFYUI_MCP_BRIDGE_PORT overrides.
-            const bridgePort = Number(process.env.COMFYUI_MCP_BRIDGE_PORT) || 9180;
-            // Remote https pod → secure wss:// tunnel (auto); local/http or
-            // --insecure-bridge → plain loopback ws://. Informational only here.
-            const secureBridge = !cli.insecureBridge && isRemoteHttpsPod(cli.comfyuiUrl);
-            const bridgeLine = secureBridge
-                ? " Agent bridge : wss:// secure Cloudflare tunnel (auto — nothing to copy)"
-                : ` Agent bridge : ws://127.0.0.1:${bridgePort}`;
-            process.stderr.write([
-                "",
-                "════════════════════════════════════════════════════════════════════",
-                " ComfyUI MCP — local agent bridge is starting",
-                "════════════════════════════════════════════════════════════════════",
-                bridgeLine,
-                ` Driving      : ${cli.comfyuiUrl}`,
-                secureBridge
-                    ? " Secure       : the pod's HTTPS panel connects automatically over an\n                encrypted tunnel — no URL to paste, works in any browser."
-                    : null,
-                "",
-                " Next steps:",
-                `   1. Open that ComfyUI in your browser: ${cli.comfyuiUrl}`,
-                "   2. In the Agent panel's Settings → General, turn ON",
-                "      'Use external/local orchestrator (advanced)'.",
-                "   3. Click Connect in the panel (the Agent panel's Connect dropdown).",
-                "",
-                " Until you click Connect this window stays quiet — that's expected, not",
-                " a hang. The agent runs HERE on your Claude/Codex login; nothing is",
-                " installed on the ComfyUI box. Keep this terminal open.",
-                "════════════════════════════════════════════════════════════════════",
-                "",
-            ]
-                .filter((l) => l !== null)
-                .join("\n"));
-        }
-        const { runPanelOrchestrator } = await import("./orchestrator/index.js");
-        await runPanelOrchestrator();
-        return;
-    }
-    await JobWatcher.cleanupOldFiles();
-    if (cli.transport === "http") {
-        // In tunnel mode, require a token even if none was configured: the endpoint
-        // is about to be exposed publicly, so generate a strong one on the fly.
-        const token = cli.token ?? (cli.tunnel ? randomBytes(24).toString("hex") : undefined);
-        await startHttpServer({
-            host: cli.host,
-            port: cli.port,
-            token,
-            allowUnauthenticated: cli.allowUnauthenticated,
-            createServer: () => createConfiguredServer(cli.toolMode),
-        });
-        logger.info(`ComfyUI MCP server running on http://${cli.host}:${cli.port}/mcp`);
-        if (token) {
-            logger.info(`HTTP MCP auth ENABLED — send 'Authorization: Bearer <token>' or 'X-API-Key: <token>'.`);
-        }
-        if (cli.tunnel) {
-            await openTunnelAndAnnounce(cli.host, cli.port, token);
-        }
-    }
-    else {
-        const server = await createConfiguredServer(cli.toolMode);
-        const transport = new StdioServerTransport();
-        await server.connect(transport);
-        logger.info("ComfyUI MCP server running on stdio");
-    }
-    // After the server is up: auto-ensure the sidebar panel (non-blocking).
-    ensurePanelOnLoad();
-    // ...and self-check the npm registry for a newer published version (non-blocking).
-    selfUpdateOnLoad();
-}
-main().catch((err) => {
-    // Error instances JSON-serialize to {} — log the message/stack explicitly so
-    // a startup failure (e.g. the unauthenticated-non-loopback guard in Docker)
-    // is actually debuggable from the console output.
-    logger.error(`Fatal error: ${err instanceof Error ? (err.stack ?? err.message) : String(err)}`);
+catch (err) {
+    // A REAL error from real code must reach the user unchanged. Only the specific
+    // "the file is not on disk" failure is translated; anything else rethrown.
+    if (!isModuleResolutionFailure(err))
+        throw err;
+    process.stderr.write(`\n${describeBrokenInstall(err)}\n`);
+    // Exit code unchanged (1): scripts and supervisors already treat that as a
+    // failed start, and moving it would be a behaviour change nobody asked for.
     process.exit(1);
-});
+}
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA,+DAA+D;AAC/D,EAAE;AACF,iFAAiF;AACjF,iFAAiF;AACjF,8EAA8E;AAC9E,kFAAkF;AAClF,2EAA2E;AAC3E,4EAA4E;AAC5E,iCAAiC;AACjC,EAAE;AACF,+EAA+E;AAC/E,kFAAkF;AAClF,mDAAmD;AACnD,OAAO,EAAE,qBAAqB,EAAE,yBAAyB,EAAE,MAAM,2BAA2B,CAAC;AAE7F,IAAI,CAAC;IACH,MAAM,MAAM,CAAC,WAAW,CAAC,CAAC;AAC5B,CAAC;AAAC,OAAO,GAAG,EAAE,CAAC;IACb,+EAA+E;IAC/E,2EAA2E;IAC3E,IAAI,CAAC,yBAAyB,CAAC,GAAG,CAAC;QAAE,MAAM,GAAG,CAAC;IAC/C,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,qBAAqB,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAC1D,2EAA2E;IAC3E,4EAA4E;IAC5E,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC"}

package/dist/tools/introspect.js

@@ -9,7 +9,7 @@
  *
  * It is NOT the whole ToolSchema: `title`, `icons`, `outputSchema`, `execution` and
  * `_meta` are dropped, so a change to any of those is invisible here. Nor does it
- * see anything behind the CONFIGURED server — createConfiguredServer() (src/index.ts)
+ * see anything behind the CONFIGURED server — createConfiguredServer() (src/boot.ts)
  * chooses full versus compact registration, and this calls registerAllTools()
  * directly. Stated explicitly because "what a client sees" invites the reading that
  * anything a client could notice is covered, and it is not.

package/dist/utils/broken-install.js

@@ -0,0 +1,115 @@
+// #1318 — a half-extracted install is silent until an unrelated-looking crash.
+//
+// A global Windows install became unusable: `@modelcontextprotocol/sdk`'s
+// `dist/esm/server/` held two empty subdirectories where a healthy install has 42
+// entries. Directories created, files never written — an interrupted extraction.
+// The install's package.json still read 0.50.46, so it presented as up to date
+// while being non-functional.
+//
+// What the user got was Node's resolver talking about a path:
+//
+//   Error [ERR_MODULE_NOT_FOUND]: Cannot find module
+//   '…\node_modules\@modelcontextprotocol\sdk\dist\esm\server\mcp.js'
+//
+// Nothing in that names comfyui-mcp, says the install is damaged, or hints at the
+// one-line repair. The reporter filed it for exactly this detection gap, and was
+// careful that the CAUSE is unproven — an interrupted `npm install -g` looks
+// identical to a failed self-update. So this diagnoses the STATE, which is
+// observable, and does not assert how it got there.
+/**
+ * Is this the failure of a missing/unreadable module, rather than an error the
+ * program threw on its own?
+ *
+ * Deliberately narrow. `ERR_MODULE_NOT_FOUND` and `MODULE_NOT_FOUND` are the two
+ * Node reports for "the file the import points at is not there", which is the
+ * observable state a half-extracted tree produces. Anything else is a real error
+ * from real code and must reach the user unchanged — swallowing it behind a
+ * "reinstall" banner would be its own defect, and a far more confusing one.
+ */
+export function isModuleResolutionFailure(err) {
+    const code = err?.code;
+    return code === "ERR_MODULE_NOT_FOUND" || code === "MODULE_NOT_FOUND";
+}
+/** The specifier Node could not resolve, when its message carries one. */
+export function missingSpecifier(err) {
+    const msg = typeof err?.message === "string" ? String(err.message) : "";
+    // "Cannot find module '<path>' imported from …" / "Cannot find package '<name>'"
+    const quoted = msg.match(/Cannot find (?:module|package) '([^']+)'/);
+    if (quoted?.[1])
+        return quoted[1];
+    return null;
+}
+/**
+ * Which of the two failures Node reported — an absent PACKAGE or an absent FILE
+ * inside one.
+ *
+ * Worth distinguishing because the repair reads differently and, more to the
+ * point, because "a file is missing: zod" is nonsense. Node says "Cannot find
+ * package" when nothing resolved the bare specifier at all, and "Cannot find
+ * module" when it resolved to a path that is not on disk — which is the
+ * half-extracted case in #1318.
+ */
+export function missingKind(err) {
+    const msg = typeof err?.message === "string" ? String(err.message) : "";
+    if (/Cannot find package '/.test(msg))
+        return "package";
+    if (/Cannot find module '/.test(msg))
+        return "module";
+    return null;
+}
+/** The package a path inside node_modules belongs to, for naming the culprit. */
+export function owningPackage(specifier) {
+    if (!specifier)
+        return null;
+    const norm = specifier.replace(/\\/g, "/");
+    const at = norm.lastIndexOf("node_modules/");
+    if (at === -1) {
+        // Not inside node_modules, so this is one of OUR OWN files, not a dependency.
+        //
+        // The first version treated any non-node_modules specifier as a bare package
+        // name, which on Windows read the drive letter off an absolute path and
+        // announced a missing dependency called "C:". An absolute or relative path is
+        // never a package name — only a bare specifier is.
+        // Tested against the NORMALIZED string: the raw one still has backslashes on
+        // Windows, so a pattern written for `/` silently matched nothing there — which
+        // is how `C:\Users\…\boot.js` came out as a dependency named "C:".
+        if (/^([a-zA-Z]:)?\//.test(norm) || norm.startsWith("."))
+            return null;
+        const m = norm.match(/^(@[^/]+\/[^/]+|[^@/][^/]*)/);
+        return m?.[1] ?? null;
+    }
+    const rest = norm.slice(at + "node_modules/".length);
+    const m = rest.match(/^(@[^/]+\/[^/]+|[^/]+)/);
+    return m?.[1] ?? null;
+}
+/**
+ * The message a user should get instead of a resolver stack trace.
+ *
+ * States the OBSERVATION (a module this install needs is not on disk) and the
+ * repair, and does NOT claim why — the reporter could not prove self-update
+ * caused it, and an interrupted `npm install -g` is indistinguishable. Asserting
+ * a cause here would send someone to fix the wrong thing.
+ */
+export function describeBrokenInstall(err) {
+    const specifier = missingSpecifier(err);
+    const pkg = owningPackage(specifier);
+    const isDependency = Boolean(pkg) && pkg !== "comfyui-mcp";
+    const what = !specifier
+        ? `a module it needs could not be loaded`
+        : // Nothing resolved the name at all: the package is absent, not damaged.
+            // Printing the bare name on the "path" line would read as `is missing: zod`.
+            missingKind(err) === "package" && isDependency
+                ? `its dependency "${pkg}" is not installed`
+                : isDependency
+                    ? `a file from its dependency "${pkg}" is missing:\n    ${specifier}`
+                    : `a file it needs is missing:\n    ${specifier}`;
+    return (`comfyui-mcp could not start: ${what}\n\n` +
+        `This install is INCOMPLETE, not misconfigured. Directories present with files missing is what an\n` +
+        `interrupted install or update leaves behind, and the recorded version still looks current — which\n` +
+        `is why nothing warned you until now.\n\n` +
+        `Repair it by reinstalling:\n\n` +
+        `    npm install -g comfyui-mcp@latest\n\n` +
+        `If you run it through npx, clear the cache first (npx clear-npx-cache) so it does not reuse the\n` +
+        `same damaged tree. Nothing else needs changing: your settings, panel and workflows are untouched.\n`);
+}
+//# sourceMappingURL=broken-install.js.map

package/dist/utils/broken-install.js.map

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

package/dist/utils/origin.js

@@ -7,11 +7,22 @@
 // orchestrator still reported "a DIFFERENT address" and advised pointing
 // COMFYUI_URL at an origin it was already pointed at.
 //
-// The same blindness scopes the workflow-instance fence, which is keyed by
-// origin: a fence adopted under one spelling would refuse under the other. That
-// half is not hypothetical either, because the relay path now DERIVES its origin
-// from COMFYUI_URL (#1077) while the loopback path OBSERVES the browser's — two
-// independent sources that can easily disagree only in spelling.
+// NOT the workflow-instance fence — this header used to claim it was, and the
+// claim was wrong. `workflowIdentityParts` (orchestrator/session-store.ts) treats
+// the origin as a PRESENCE gate: it requires one to exist and never compares it
+// against a previously bound value. Both of its callers read `.uuid` and nothing
+// in the repo has ever read `identity.origin`, so two spellings of one host
+// cannot make a fence "adopted under one spelling refuse under the other".
+//
+// That sentence is deleted rather than softened because of what believing it
+// costs. The same false lead, in the pre-#1255 wording of the fence refusal
+// itself, already burned one full investigation and a closed-unmerged PR; it
+// then burned a second (#1321) via a stale quote of that message preserved in an
+// issue thread. A comment asserting a caller that does not exist is the same
+// defect as a message describing a check that does not run.
+//
+// If a fence ever does start comparing origins, wire it to `sameOrigin` and say
+// so here — but the wiring must come first, and the sentence second.
 //
 // WHY THIS IS ITS OWN MODULE. Three loopback notions already exist
 // (`isLoopbackServerUrl`, `port-owner`'s LOOPBACK/WILDCARD split,

package/dist/utils/origin.js.map

@@ -1 +1 @@
-{"version":3,"file":"origin.js","sourceRoot":"","sources":["../../src/utils/origin.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,EAAE;AACF,gFAAgF;AAChF,+EAA+E;AAC/E,6EAA6E;AAC7E,uEAAuE;AACvE,yEAAyE;AACzE,sDAAsD;AACtD,EAAE;AACF,2EAA2E;AAC3E,gFAAgF;AAChF,iFAAiF;AACjF,gFAAgF;AAChF,iEAAiE;AACjE,EAAE;AACF,mEAAmE;AACnE,kEAAkE;AAClE,4EAA4E;AAC5E,4EAA4E;AAC5E,0EAA0E;AAC1E,2EAA2E;AAE3E;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,cAAc,GAAG,IAAI,GAAG,CAAC,CAAC,WAAW,EAAE,WAAW,EAAE,OAAO,CAAC,CAAC,CAAC;AAEpE,4EAA4E;AAC5E,MAAM,kBAAkB,GAAG,WAAW,CAAC;AAEvC;;;;;GAKG;AACH,MAAM,UAAU,eAAe,CAAC,GAAuB;IACrD,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE;QAAE,OAAO,SAAS,CAAC;IAC7D,IAAI,MAAW,CAAC;IAChB,IAAI,CAAC;QACH,MAAM,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC;IAC/B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC;IAC7B,2EAA2E;IAC3E,IAAI,CAAC,MAAM,IAAI,MAAM,KAAK,MAAM;QAAE,OAAO,SAAS,CAAC;IACnD,yEAAyE;IACzE,+EAA+E;IAC/E,yEAAyE;IACzE,8EAA8E;IAC9E,oEAAoE;IACpE,MAAM,IAAI,GAAG,MAAM,CAAC,QAAQ,CAAC,WAAW,EAAE,CAAC;IAC3C,MAAM,IAAI,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IAC3D,MAAM,SAAS,GAAG,cAAc,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,kBAAkB,CAAC,CAAC,CAAC,IAAI,CAAC;IACvE,8EAA8E;IAC9E,8EAA8E;IAC9E,4DAA4D;IAC5D,OAAO,GAAG,MAAM,CAAC,QAAQ,KAAK,SAAS,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;AACnF,CAAC;AAED,0EAA0E;AAC1E,MAAM,UAAU,UAAU,CAAC,CAAqB,EAAE,CAAqB;IACrE,MAAM,IAAI,GAAG,eAAe,CAAC,CAAC,CAAC,CAAC;IAChC,MAAM,KAAK,GAAG,eAAe,CAAC,CAAC,CAAC,CAAC;IACjC,2EAA2E;IAC3E,6EAA6E;IAC7E,wBAAwB;IACxB,OAAO,IAAI,KAAK,SAAS,IAAI,IAAI,KAAK,KAAK,CAAC;AAC9C,CAAC"}
+{"version":3,"file":"origin.js","sourceRoot":"","sources":["../../src/utils/origin.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,EAAE;AACF,gFAAgF;AAChF,+EAA+E;AAC/E,6EAA6E;AAC7E,uEAAuE;AACvE,yEAAyE;AACzE,sDAAsD;AACtD,EAAE;AACF,8EAA8E;AAC9E,kFAAkF;AAClF,gFAAgF;AAChF,iFAAiF;AACjF,4EAA4E;AAC5E,2EAA2E;AAC3E,EAAE;AACF,6EAA6E;AAC7E,4EAA4E;AAC5E,6EAA6E;AAC7E,iFAAiF;AACjF,6EAA6E;AAC7E,4DAA4D;AAC5D,EAAE;AACF,gFAAgF;AAChF,qEAAqE;AACrE,EAAE;AACF,mEAAmE;AACnE,kEAAkE;AAClE,4EAA4E;AAC5E,4EAA4E;AAC5E,0EAA0E;AAC1E,2EAA2E;AAE3E;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,cAAc,GAAG,IAAI,GAAG,CAAC,CAAC,WAAW,EAAE,WAAW,EAAE,OAAO,CAAC,CAAC,CAAC;AAEpE,4EAA4E;AAC5E,MAAM,kBAAkB,GAAG,WAAW,CAAC;AAEvC;;;;;GAKG;AACH,MAAM,UAAU,eAAe,CAAC,GAAuB;IACrD,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE;QAAE,OAAO,SAAS,CAAC;IAC7D,IAAI,MAAW,CAAC;IAChB,IAAI,CAAC;QACH,MAAM,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC;IAC/B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC;IAC7B,2EAA2E;IAC3E,IAAI,CAAC,MAAM,IAAI,MAAM,KAAK,MAAM;QAAE,OAAO,SAAS,CAAC;IACnD,yEAAyE;IACzE,+EAA+E;IAC/E,yEAAyE;IACzE,8EAA8E;IAC9E,oEAAoE;IACpE,MAAM,IAAI,GAAG,MAAM,CAAC,QAAQ,CAAC,WAAW,EAAE,CAAC;IAC3C,MAAM,IAAI,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IAC3D,MAAM,SAAS,GAAG,cAAc,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,kBAAkB,CAAC,CAAC,CAAC,IAAI,CAAC;IACvE,8EAA8E;IAC9E,8EAA8E;IAC9E,4DAA4D;IAC5D,OAAO,GAAG,MAAM,CAAC,QAAQ,KAAK,SAAS,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;AACnF,CAAC;AAED,0EAA0E;AAC1E,MAAM,UAAU,UAAU,CAAC,CAAqB,EAAE,CAAqB;IACrE,MAAM,IAAI,GAAG,eAAe,CAAC,CAAC,CAAC,CAAC;IAChC,MAAM,KAAK,GAAG,eAAe,CAAC,CAAC,CAAC,CAAC;IACjC,2EAA2E;IAC3E,6EAA6E;IAC7E,wBAAwB;IACxB,OAAO,IAAI,KAAK,SAAS,IAAI,IAAI,KAAK,KAAK,CAAC;AAC9C,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "comfyui-mcp",
-  "version": "0.50.93",
+  "version": "0.50.94",
   "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",