comfyui-mcp 0.27.0 → 0.28.0

package/dist/orchestrator/backend-readiness.js

@@ -17,6 +17,7 @@ const CLI_NAMES = {
     codex: ["codex", "codex.cmd", "codex.exe"],
     gemini: ["gemini", "gemini.cmd", "gemini.exe"],
     ollama: ["ollama", "ollama.exe"],
+    lmstudio: ["lms", "lms.exe"],
 };
 /** Well-known Ollama install locations probed in addition to PATH (the Windows
  *  installer adds PATH for NEW shells only — an orchestrator started from an
@@ -30,6 +31,32 @@ function ollamaInstalled(home) {
     }
     return fileExists("/usr/local/bin/ollama") || fileExists("/opt/homebrew/bin/ollama");
 }
+/** LM Studio install signals: the app drops its `lms` CLI at ~/.lmstudio/bin on
+ *  every platform (best cross-OS marker), plus the per-OS app locations. */
+function lmstudioInstalled(home) {
+    if (lmstudioCliPath(home))
+        return true;
+    if (process.platform === "win32") {
+        const localAppData = process.env.LOCALAPPDATA || join(home, "AppData", "Local");
+        return fileExists(localAppData, "Programs", "LM Studio", "LM Studio.exe");
+    }
+    if (process.platform === "darwin")
+        return fileExists("/Applications", "LM Studio.app");
+    return fileExists(home, ".lmstudio");
+}
+/** Absolute path (or bare name if on PATH) of the `lms` CLI — the supported
+ *  programmatic surface for load/unload/server lifecycle. Used by
+ *  services/lmstudio-lifecycle to shell out even when PATH lacks it (the app
+ *  adds ~/.lmstudio/bin to PATH for NEW shells only). Null when not found. */
+export function lmstudioCliPath(home = homedir()) {
+    if (onPath(CLI_NAMES.lmstudio))
+        return "lms";
+    const binName = process.platform === "win32" ? "lms.exe" : "lms";
+    const inHome = join(home, ".lmstudio", "bin", binName);
+    if (fileExists(inHome))
+        return inHome;
+    return null;
+}
 /** True if any of `names` resolves on the local PATH. */
 function onPath(names) {
     const sep = process.platform === "win32" ? ";" : ":";
@@ -90,6 +117,13 @@ export function backendReadiness(backend, opts) {
         const cli = ollamaInstalled(home);
         return { backend: "ollama", cli, auth: cli ? true : null, ready: cli };
     }
+    if (b === "lmstudio") {
+        // Same posture as ollama: a local server, no login concept. App/CLI
+        // presence is the readiness signal; a stopped server still surfaces via
+        // the connect ack's model probe (GET /v1/models fails → degraded ack).
+        const cli = lmstudioInstalled(home);
+        return { backend: "lmstudio", cli, auth: cli ? true : null, ready: cli };
+    }
     if (b === "openrouter") {
         // Hosted — no CLI. Readiness = an OpenRouter API key in the orchestrator's
         // env (OPENROUTER_API_KEY, or the shared COMFYUI_MCP_OLLAMA_API_KEY). A bad

package/dist/orchestrator/backend-readiness.js.map

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

package/dist/orchestrator/index.js

@@ -33,6 +33,7 @@ import { startPanelMcpHttpServer } from "./panel-mcp-http.js";
 import { readComfyuiCrashLog, formatCrashNote } from "../services/crash-log.js";
 import { QueueMonitor } from "../services/queue-monitor.js";
 import { unloadAllOllama, warmOllama, resolveOllamaHost } from "../services/ollama-vram.js";
+import { isLocalLmstudio, startLmstudioServer, unloadAllLmstudio, warmLmstudio, } from "../services/lmstudio-lifecycle.js";
 import { getAgentSettings, setAgentSettings } from "../services/panel-settings.js";
 import { gatherEnvCapabilities, buildPanelSystemAppend, } from "../services/env-capabilities.js";
 const PANEL_SYSTEM_APPEND = `You are the autonomous assistant embedded directly in a ComfyUI sidebar panel. The person is working in ComfyUI and talks to you through that panel: their messages arrive as your prompts, and everything you write is shown to them in the panel chat. Write for that reader — lead with the result, keep replies short and concrete, and don't narrate routine internal steps.
@@ -119,6 +120,21 @@ const injectedCrashes = new Set();
  *  doesn't prepend the same warning to every message. A new running prompt id (or
  *  a fresh backlog) produces a new key and warns again. Process-scoped. */
 const injectedQueueNotes = new Set();
+/** HEADLESS clients (the mobile / remote pseudo-panel) connect with NO ComfyUI
+ *  browser panel. Two consequences: the live-canvas panel_* tools can't run, AND
+ *  — critically — nothing observes a render finishing to auto-deliver its output
+ *  back to the agent (that path is browser-driven; see the `agent_event` handler).
+ *  generate_image / enqueue_workflow return a prompt_id immediately, so a headless
+ *  agent that "ends its turn and waits" never surfaces the image. This directive,
+ *  prepended to each headless-tab turn like the crash/queue notes, tells it to run
+ *  headless and deliver the result ITSELF, in-turn. */
+const HEADLESS_DIRECTIVE = "[HEADLESS SESSION — no ComfyUI panel/canvas is connected] The panel_* live-canvas tools " +
+    "(panel_run, panel_get_graph, panel_set_widget, panel_add_node, …) are UNAVAILABLE here and will fail — " +
+    "do everything through the comfyui MCP tools (generate_image, or create_workflow + enqueue_workflow). " +
+    "There is NO panel to auto-deliver a finished render, so you MUST deliver the result YOURSELF IN THIS SAME TURN: " +
+    "enqueuing returns a prompt_id immediately, so wait for it with get_job_status(prompt_id) — poll it briefly until " +
+    "it reports completion (this is the ONE case where polling IS correct) — then fetch the output with get_history and " +
+    "show it with panel_show_media. Do NOT end your turn expecting an automatic notification; none will arrive.";
 /** Live stall threshold (seconds) pushed from the panel setting via a `set_config`
  *  frame — applies WITHOUT a reconnect. null = not set, fall back to env then the
  *  built-in default. Process-global: one ComfyUI per orchestrator. */
@@ -830,6 +846,13 @@ export async function runPanelOrchestrator() {
             ...(key ? { apiKey: key } : {}),
         };
     };
+    // LM Studio (issue #160) = the same openai dialect pinned to LM Studio's
+    // local server. No API key, no login. Default model is EMPTY on purpose —
+    // LM Studio model ids are user-specific, so ensureModels() below fills it
+    // with the first id the server actually offers.
+    const LMSTUDIO_BASE_URL = (process.env.COMFYUI_MCP_LMSTUDIO_HOST ?? "http://127.0.0.1:1234/v1").replace(/[/]$/, "");
+    let lmstudioModel = process.env.COMFYUI_MCP_LMSTUDIO_MODEL ?? persistedAgent.lmstudio?.model ?? "";
+    const lmstudioDeps = () => ({ api: "openai", host: LMSTUDIO_BASE_URL });
     // ── Per-tab backend (single-port multi-provider) ──────────────────────────
     // ONE orchestrator on ONE bridge port serves ALL providers; the panel picks a
     // provider per tab via the `hello`/`set_backend` handshake, instead of the node
@@ -839,10 +862,11 @@ export async function runPanelOrchestrator() {
     // provider (the panel replays the transcript to seed it) while a same-provider
     // reconnect RESUMES. `backendId`/`codexModel`/`geminiModel` above are the
     // DEFAULT + per-provider model config; the process is no longer pinned to one.
-    const KNOWN_BACKENDS = new Set(["claude", "codex", "gemini", "ollama", "openrouter"]);
+    const KNOWN_BACKENDS = new Set(["claude", "codex", "gemini", "ollama", "openrouter", "lmstudio"]);
     const defaultBackend = KNOWN_BACKENDS.has(backendId) ? backendId : "claude";
     const AGENT_KEY_SEP = "::";
     const tabBackends = new Map(); // panel tabId -> selected backend
+    const headlessTabs = new Set(); // tabs with no ComfyUI canvas (mobile/remote) — deliver renders in-turn
     const backendForTab = (panelTabId) => tabBackends.get(panelTabId) ?? defaultBackend;
     const agentKeyFor = (panelTabId) => panelTabId + AGENT_KEY_SEP + backendForTab(panelTabId);
     // A panel tab id never contains "::"; backend names never do — so split on the
@@ -996,6 +1020,16 @@ export async function runPanelOrchestrator() {
                 ...openrouterDeps(),
             });
         }
+        if (backend === "lmstudio") {
+            return new OllamaBackend({
+                cwd: comfyuiPath ?? process.cwd(),
+                model: lmstudioModel,
+                systemAppend: panelSystemAppend,
+                comfyuiUrl,
+                mcpServers: makeHttpBackendMcpServers(panelTabId),
+                ...lmstudioDeps(),
+            });
+        }
         return undefined; // claude → built-in ClaudeBackend
     };
     logger.info(`[panel-orchestrator] single-port multi-provider: default backend=${defaultBackend}; ` +
@@ -1018,7 +1052,9 @@ export async function runPanelOrchestrator() {
                         ? new OllamaBackend({ cwd: comfyuiPath ?? process.cwd(), model: ollamaModel, ...ollamaDeps() })
                         : backend === "openrouter"
                             ? new OllamaBackend({ cwd: comfyuiPath ?? process.cwd(), model: openrouterModel, ...openrouterDeps() })
-                            : new GeminiBackend({ cwd: comfyuiPath ?? process.cwd(), model: geminiModel });
+                            : backend === "lmstudio"
+                                ? new OllamaBackend({ cwd: comfyuiPath ?? process.cwd(), model: lmstudioModel, ...lmstudioDeps() })
+                                : new GeminiBackend({ cwd: comfyuiPath ?? process.cwd(), model: geminiModel });
             probeBackends.set(backend, pb);
         }
         return pb;
@@ -1123,17 +1159,26 @@ export async function runPanelOrchestrator() {
     const pauseLocalDuringGen = process.env.COMFYUI_MCP_OLLAMA_PAUSE_ON_GEN !== "0";
     const anyLocalOllama = () => ollamaApi === "ollama" &&
         (defaultBackend === "ollama" || [...tabBackends.values()].includes("ollama"));
+    // LM Studio joins the same VRAM handoff (issue #160 follow-up): local server
+    // only — a remote COMFYUI_MCP_LMSTUDIO_HOST is someone else's VRAM.
+    const anyLocalLmstudio = () => isLocalLmstudio(LMSTUDIO_BASE_URL) &&
+        (defaultBackend === "lmstudio" || [...tabBackends.values()].includes("lmstudio"));
     // agentKey -> messages held while a render runs (flushed on render end).
     const heldDuringGen = new Map();
     let genPauseActive = false;
     if (pauseLocalDuringGen) {
         QueueMonitor.setTransitionHandlers({
             onRunStart: () => {
-                if (!anyLocalOllama())
+                const ol = anyLocalOllama();
+                const ls = anyLocalLmstudio();
+                if (!ol && !ls)
                     return;
                 genPauseActive = true;
                 // Free the local model's VRAM for the render (best-effort, fire-and-forget).
-                void unloadAllOllama(resolveOllamaHost());
+                if (ol)
+                    void unloadAllOllama(resolveOllamaHost());
+                if (ls)
+                    void unloadAllLmstudio(LMSTUDIO_BASE_URL);
             },
             onRunEnd: () => {
                 if (!genPauseActive)
@@ -1145,6 +1190,8 @@ export async function runPanelOrchestrator() {
                 // loads the model itself — no separate warm needed.
                 if (anyLocalOllama() && !hadHeld)
                     void warmOllama(resolveOllamaHost(), ollamaModel);
+                if (anyLocalLmstudio() && !hadHeld && lmstudioModel)
+                    void warmLmstudio(LMSTUDIO_BASE_URL, lmstudioModel);
                 for (const [key, msgs] of heldDuringGen) {
                     const tabId = panelTabOf(key);
                     if (msgs.length > 0) {
@@ -1275,6 +1322,14 @@ export async function runPanelOrchestrator() {
             p = probe.then((list) => {
                 if (!list.length)
                     modelsByBackend.delete(backend); // don't cache a failed probe
+                // LM Studio ships no sane hardcoded default (model ids are whatever the
+                // user downloaded) — adopt the server's first offering when unset.
+                if (backend === "lmstudio" && !lmstudioModel && list.length) {
+                    lmstudioModel = list[0].value ?? "";
+                    if (lmstudioModel) {
+                        logger.info(`[panel-orchestrator] lmstudio default model → ${lmstudioModel} (first served)`);
+                    }
+                }
                 // User-curated preferred models (panel Settings → set_config) pin to the
                 // top of the ollama picker, ahead of the discovered catalog. Read fresh
                 // on every probe; set_config evicts the cache so edits apply live.
@@ -1309,6 +1364,8 @@ export async function runPanelOrchestrator() {
             return ollamaModel;
         if (backend === "openrouter")
             return openrouterModel;
+        if (backend === "lmstudio")
+            return lmstudioModel || undefined;
         return model;
     }
     function pushModels(panelTabId) {
@@ -1405,6 +1462,12 @@ export async function runPanelOrchestrator() {
                 manager.reset(panelTab + AGENT_KEY_SEP + prev);
             }
             tabBackends.set(panelTab, backend);
+            // A headless client (mobile/remote pseudo-panel, no browser canvas) advertises
+            // itself in the hello frame so its agent gets the in-turn-delivery directive.
+            if (event.headless === true)
+                headlessTabs.add(panelTab);
+            else
+                headlessTabs.delete(panelTab);
             const key = panelTab + AGENT_KEY_SEP + backend;
             // Reload restore: the panel re-sends the last session id it saw. Honored
             // only for a SAME-provider (re)connect — a switch always starts fresh. The
@@ -1431,6 +1494,7 @@ export async function runPanelOrchestrator() {
             const isGm = backend === "gemini";
             const isOl = backend === "ollama";
             const isOr = backend === "openrouter";
+            const isLs = backend === "lmstudio";
             // TRUTHFUL "connected": only claim ready after PROVING the SELECTED backend
             // can run, by probing its model list. If the probe fails — the "connected
             // but dead" wedge — send a degraded ack so the panel shows the real state.
@@ -1448,7 +1512,9 @@ export async function runPanelOrchestrator() {
                 logger.warn(`[panel-orchestrator] tab ${panelTab.slice(0, 8)} connected (openrouter) but no API key — degraded ack`);
                 return;
             }
-            void ensureModels(backend)
+            void (isLs && isLocalLmstudio(LMSTUDIO_BASE_URL)
+                ? startLmstudioServer(LMSTUDIO_BASE_URL).then(() => ensureModels(backend))
+                : ensureModels(backend))
                 .then((models) => {
                 if (models.length) {
                     const agentLabel = isCx
@@ -1457,9 +1523,11 @@ export async function runPanelOrchestrator() {
                             ? (geminiModel ?? models[0].value ?? "Gemini")
                             : isOl
                                 ? (ollamaModel ?? models[0].value ?? "Ollama")
-                                : isOr
-                                    ? (openrouterModel ?? models[0].value ?? "OpenRouter")
-                                    : model;
+                                : isLs
+                                    ? (lmstudioModel || (models[0].value ?? "LM Studio"))
+                                    : isOr
+                                        ? (openrouterModel ?? models[0].value ?? "OpenRouter")
+                                        : model;
                     // Greet only on a FRESH session (a resume/reconnect already has the thread).
                     if (!resume) {
                         const readyText = isCx
@@ -1468,9 +1536,11 @@ export async function runPanelOrchestrator() {
                                 ? `🟢 comfyui-mcp agent ready — ${agentLabel} on your Google account (Gemini Code Assist). Ask away.`
                                 : isOl
                                     ? `🟢 comfyui-mcp agent ready — ${agentLabel} running locally via Ollama (no account, no API key). Small local models are slower and simpler than frontier ones — expect fewer frills. Ask away.`
-                                    : isOr
-                                        ? `🟢 comfyui-mcp agent ready — ${agentLabel} via OpenRouter (hosted API, your OPENROUTER_API_KEY). Ask away.`
-                                        : `🟢 comfyui-mcp agent ready — ${agentLabel} on your Claude subscription. Ask away.`;
+                                    : isLs
+                                        ? `🟢 comfyui-mcp agent ready — ${agentLabel} running locally via LM Studio (no account, no API key). Small local models are slower and simpler than frontier ones — expect fewer frills. Ask away.`
+                                        : isOr
+                                            ? `🟢 comfyui-mcp agent ready — ${agentLabel} via OpenRouter (hosted API, your OPENROUTER_API_KEY). Ask away.`
+                                            : `🟢 comfyui-mcp agent ready — ${agentLabel} on your Claude subscription. Ask away.`;
                         bridge.push({ type: "say", text: readyText }, panelTab);
                     }
                     bridge.push({ type: "ack", ok: true, kind: "ready", agent: agentLabel, backend }, panelTab);
@@ -1483,7 +1553,9 @@ export async function runPanelOrchestrator() {
                             ? "⚠️ The background agent isn't responding — the Gemini CLI couldn't start. Make sure the Gemini CLI is installed and signed in (run `gemini` once and complete the Google sign-in), then Disconnect → Connect to retry."
                             : isOl
                                 ? "⚠️ The background agent isn't responding — Ollama isn't reachable. Start it with `ollama serve` and pull our fine-tuned model (`ollama pull artokun/gemma4-comfyui-mcp:e4b` — gemma4 trained on the comfyui-mcp tool suite; `:e2b` for ~2 GB VRAM, `:12b` for ~8 GB), then Disconnect → Connect to retry."
-                                : "⚠️ The background agent isn't responding — the Claude Agent SDK couldn't start. Make sure you're signed in (run `claude` once), then Disconnect → Connect to retry.";
+                                : isLs
+                                    ? `⚠️ The background agent isn't responding — LM Studio isn't reachable at ${LMSTUDIO_BASE_URL}. Open LM Studio → Developer → Start Server and load a tool-calling model (our gemma4-comfyui-mcp GGUFs from Hugging Face work great), or set COMFYUI_MCP_LMSTUDIO_HOST if it serves elsewhere — then Disconnect → Connect to retry.`
+                                    : "⚠️ The background agent isn't responding — the Claude Agent SDK couldn't start. Make sure you're signed in (run `claude` once), then Disconnect → Connect to retry.";
                     bridge.push({ type: "say", text: degradedText }, panelTab);
                     bridge.push({ type: "ack", ok: false, kind: "degraded" }, panelTab);
                     logger.warn(`[panel-orchestrator] tab ${panelTab.slice(0, 8)} connected (${backend}) but model probe empty — degraded ack`);
@@ -1511,6 +1583,21 @@ export async function runPanelOrchestrator() {
             if (prev !== reqBackend)
                 manager.reset(panelTab + AGENT_KEY_SEP + prev);
             tabBackends.set(panelTab, reqBackend);
+            // Leaving a LOCAL provider frees its VRAM (no other tab still on it) —
+            // the point of switching to Claude/hosted is usually reclaiming the GPU.
+            if (prev !== reqBackend) {
+                const stillUsed = (b) => [...tabBackends.values()].includes(b) || defaultBackend === b;
+                if (prev === "lmstudio" && !stillUsed("lmstudio") && isLocalLmstudio(LMSTUDIO_BASE_URL)) {
+                    void unloadAllLmstudio(LMSTUDIO_BASE_URL);
+                }
+                if (prev === "ollama" && !stillUsed("ollama") && ollamaApi === "ollama") {
+                    void unloadAllOllama(resolveOllamaHost());
+                }
+                // Switching TO lmstudio: make sure its server is up (auto-start, no
+                // manual `lms server start`) so the readiness probe finds it alive.
+                if (reqBackend === "lmstudio")
+                    void startLmstudioServer(LMSTUDIO_BASE_URL);
+            }
             pushModels(panelTab);
             if (reqBackend === "claude")
                 pushCommands(panelTab);
@@ -1567,6 +1654,22 @@ export async function runPanelOrchestrator() {
                     logger.info(`[panel-orchestrator] ollama config → model=${ollamaModel} api=${ollamaApi} host=${ollamaBaseUrl ?? "(default)"}`);
                 }
             }
+            const lcfg = event.lmstudio;
+            if (lcfg && typeof lcfg === "object") {
+                const o = lcfg;
+                if (typeof o.model === "string" && o.model.trim()) {
+                    const m = o.model.trim();
+                    if (!process.env.COMFYUI_MCP_LMSTUDIO_MODEL)
+                        lmstudioModel = m;
+                    setAgentSettings({ lmstudio: { model: m } });
+                    const pb = probeBackends.get("lmstudio");
+                    if (pb?.close)
+                        void pb.close().catch(() => { });
+                    probeBackends.delete("lmstudio");
+                    modelsByBackend.delete("lmstudio");
+                    logger.info(`[panel-orchestrator] lmstudio config → model=${lmstudioModel}`);
+                }
+            }
             if (ollamaChanged) {
                 modelsByBackend.delete("ollama");
                 pushModels(event.tab_id);
@@ -1623,6 +1726,12 @@ export async function runPanelOrchestrator() {
                         nextModel = undefined;
                     }
                 }
+                // LM Studio model switch: unload everything EXCEPT the incoming model —
+                // the outgoing one would otherwise sit in VRAM next to the JIT-loaded
+                // replacement until its TTL expires.
+                if (nextModel && backendForTab(tabId) === "lmstudio" && isLocalLmstudio(LMSTUDIO_BASE_URL)) {
+                    void unloadAllLmstudio(LMSTUDIO_BASE_URL, nextModel);
+                }
                 const applied = await manager.setOptions(agentKeyFor(tabId), { model: nextModel, effort: nextEffort });
                 bridge.push({
                     type: "ack",
@@ -1788,6 +1897,14 @@ export async function runPanelOrchestrator() {
         catch (err) {
             logger.debug(`[panel-orchestrator] queue-note check failed (ignored): ${err instanceof Error ? err.message : String(err)}`);
         }
+        // HEADLESS delivery: a mobile/remote tab has no browser panel to auto-deliver a
+        // finished render, so remind its agent — every turn, since it must hold for the
+        // whole session — to run headless and show the output itself in-turn. The note is
+        // short and always-correct, so (unlike the once-per-episode crash/queue notes) it
+        // is injected on every headless turn.
+        if (headlessTabs.has(event.tab_id)) {
+            outText = `${HEADLESS_DIRECTIVE}\n\n${outText}`;
+        }
         // Transcript replay (single-port provider switch): the panel sends the prior
         // conversation as `context` on the FIRST message to a freshly-switched
         // provider, so the new backend has the thread (minus internal session data —
@@ -1807,10 +1924,9 @@ export async function runPanelOrchestrator() {
         // render is in flight, DON'T run the turn now — that would reload the model
         // on top of the generation (VRAM contention / OOM). Hold it and answer when
         // the render finishes (onRunEnd flushes the queue + warms the model).
-        if (pauseLocalDuringGen &&
-            ollamaApi === "ollama" &&
-            backendForTab(event.tab_id) === "ollama" &&
-            QueueMonitor.isBusy()) {
+        const tabIsLocalVram = (ollamaApi === "ollama" && backendForTab(event.tab_id) === "ollama") ||
+            (backendForTab(event.tab_id) === "lmstudio" && isLocalLmstudio(LMSTUDIO_BASE_URL));
+        if (pauseLocalDuringGen && tabIsLocalVram && QueueMonitor.isBusy()) {
             const key = agentKeyFor(event.tab_id);
             const arr = heldDuringGen.get(key) ?? [];
             arr.push({ text: outText, opts: sendOpts });