Release 0.1.3: isolate Prompter and migrate saved workflows

CHANGELOG.md

@@ -1,5 +1,12 @@
 # Changelog
 
+## 0.1.3 — 2026-09-29
+
+- Give the new Prompter the unique internal ID `DMAINodesPrompter`, keeping its visible name **DMAI Prompter**. Older DMAI Suite and standalone Prompter installations can keep their original node and frontend hooks.
+- Upgrade identifiable DMAI NODES 0.1.0-0.1.2 UI workflows before loading; preserve legacy Prompters, node IDs, links and settings.
+- Update starter workflows and progress tracking. Add an offline workflow migration tool and migration in the API submission helper, preserving source files.
+- Isolate the new LoRA row and filename CSS classes from the older DMAI LoRA Loader styles.
+
 ## 0.1.2 — 2026-09-28
 
 - Fixed native socket dragging: DOM panels leave real canvas gutters around input and output hit targets. Hidden JSON widgets no longer affect socket spacing.

DMAI-NODES-v0.1.3.zip

@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:1a68ce0492afcfcfd16894affb05b1667661fd9658b79be4d590139771ab07d2
+size 149760

DMAI-NODES-v0.1.3.zip.sha256

@@ -0,0 +1 @@
+1a68ce0492afcfcfd16894affb05b1667661fd9658b79be4d590139771ab07d2  DMAI-NODES-v0.1.3.zip

README.md

@@ -14,7 +14,7 @@ tags:
 
 **A compact image workflow for ComfyUI.** Slate surfaces, clean Inter typography and English controls.
 
-**0.1.2 preview** · [GitHub releases](https://github.com/ceroomedia/DMAI-NODES/releases) · [Hugging Face download mirror](https://huggingface.co/ceroomedia/DMAI-NODES)
+**0.1.3 preview** · [GitHub releases](https://github.com/ceroomedia/DMAI-NODES/releases) · [Hugging Face download mirror](https://huggingface.co/ceroomedia/DMAI-NODES)
 
 Prompter → Generation Engine → Gallery, with an ordered LoRA Loader feeding the engine.
 
@@ -44,6 +44,8 @@ python -m pip install -r custom_nodes/DMAI-NODES/requirements.txt
 
 Restart ComfyUI and refresh the browser. Search for **DMAI** in the node library.
 
+**Using an older DMAI package too?** Version 0.1.3 gives this package's Prompter its own internal ID, `DMAINodesPrompter`. Choose **DMAI Prompter** from the **DMAI-NODES** package in category **DMAI NODES**. The older Suite and standalone Prompter keep their existing IDs. See [updating from 0.1.2](docs/INSTALLATION.md#updating-from-012-or-earlier) for saved workflows and API clients.
+
 - [Windows Portable, local environments and Runpod](docs/INSTALLATION.md)
 - [Model files, presets and enhancement](docs/MODELS.md)
 - [API workflow and future website integration](docs/API.md)

dmai_nodes/__init__.py

@@ -1,2 +1,2 @@
 """DMAI NODES domain modules; importing these does not initialize a GPU."""
-__version__ = "0.1.2"
+__version__ = "0.1.3"

dmai_nodes/nodes.py

@@ -22,10 +22,10 @@ def json_config(value):
     return read_json(value)
 
 
-class DMAIPrompter(io.ComfyNode):
+class DMAINodesPrompter(io.ComfyNode):
     @classmethod
     def define_schema(cls):
-        return io.Schema(node_id="DMAIPrompter",display_name="DMAI Prompter",category="DMAI NODES",
+        return io.Schema(node_id="DMAINodesPrompter",display_name="DMAI Prompter",category="DMAI NODES",
             description="Prompt, dimensions and image count. Optional text input is prepended to local text.",
             inputs=[io.String.Input("config_json",default=json.dumps(DEFAULT_PROMPT),multiline=True,socketless=True),
                     io.String.Input("text",optional=True,force_input=True,advanced=True,tooltip="Optional source text, followed by the local prompt.")],
@@ -139,4 +139,4 @@ class DMAIVAEDecode(io.ComfyNode):
         return io.NodeOutput(VAEDecode().decode(vae,latent)[0])
 
 
-NODE_CLASSES=[DMAIPrompter,DMAILoRAStack,DMAIGenerationEngine,DMAIGallery,DMAIKreaEnhancer,DMAIVAEEncode,DMAIVAEDecode]
+NODE_CLASSES=[DMAINodesPrompter,DMAILoRAStack,DMAIGenerationEngine,DMAIGallery,DMAIKreaEnhancer,DMAIVAEEncode,DMAIVAEDecode]

docs/API.md

@@ -24,6 +24,18 @@ In a completed starter job, Gallery metadata is at `history[prompt_id]["outputs"
 
 Use seed strings for the full unsigned 64-bit range; JavaScript numbers cannot represent all of it exactly. Each image's exact seed is recorded in the Engine report. The CLI timeout only stops waiting; it does not cancel the job.
 
+## Prompter ID migration
+
+Version 0.1.3 uses `DMAINodesPrompter` as the Prompter's API `class_type`. The request configuration, `DMAI_PROMPT` output and Engine connections keep the same contracts. Older DMAI packages still own `DMAIPrompter`; the server intentionally has no alias that could overwrite them.
+
+Use the updated starter API files for new integrations. The included `run_workflow.py` converts identifiable 0.1.0-0.1.2 DMAI NODES Prompters in memory before submitting and leaves the source file intact. Direct `/prompt` callers should migrate their template first:
+
+```bash
+python custom_nodes/DMAI-NODES/tools/migrate_workflow.py old-workflow.api.json --output migrated-workflow.api.json
+```
+
+The offline tool also accepts saved UI workflows. It requires a new output path and never replaces the source. Only records matching the new package's configuration and connection contracts are converted. Legacy CLIP/conditioning Prompters and ambiguous records remain unchanged; do not replace every occurrence of `DMAIPrompter` globally. UI workflows loaded in Comfy's frontend are migrated before nodes are created.
+
 ## Generation progress over WebSocket
 
 Connect to ComfyUI's `/ws?clientId=<client ID>` before submitting the workflow. Use the same ID as `client_id` in `POST /prompt`. The Engine sends `dmai_generation_progress` messages to that client through ComfyUI's existing WebSocket:

docs/INSTALLATION.md

@@ -77,9 +77,29 @@ git -C .\ComfyUI\custom_nodes\DMAI-NODES pull --ff-only
 
 Restart ComfyUI afterward. For ZIP installations, replace package files from the new release while preserving your workflows and output. To uninstall, remove only the custom-node folder after stopping ComfyUI. Saved originals and the gallery index are in `output/DMAI-NODES` and are not removed by package updates.
 
+### Updating from 0.1.2 or earlier
+
+The new Prompter now registers as `DMAINodesPrompter`. Its visible name remains **DMAI Prompter**, under **DMAI NODES**, with the **DMAI-NODES** package badge. Older DMAI Suite and standalone Prompter installations use `DMAIPrompter`; they can remain enabled alongside this package.
+
+To install exactly this release from an existing Git checkout, including a checkout pinned to an older tag, run inside `custom_nodes/DMAI-NODES`:
+
+```bash
+git fetch origin tag v0.1.3
+git checkout v0.1.3
+python -m pip install -r requirements.txt
+git describe --tags --exact-match
+```
+
+Use ComfyUI's Python environment for the dependency command; Windows Portable uses `..\..\..\python_embeded\python.exe` from that node directory. Restart ComfyUI, then hard-refresh the browser with Ctrl+F5.
+
+UI workflows saved by DMAI NODES 0.1.0-0.1.2 are upgraded on load only when their Prompter data and output identify this package. Save the workflow after loading it. Legacy Suite/standalone Prompters keep their original IDs and connections. Ambiguous or damaged records are left for manual correction.
+
+For API JSON sent directly to `/prompt`, use the new `DMAINodesPrompter` class type. The included API helper and offline conversion tool handle identifiable older DMAI NODES API workflows; see [API migration](API.md#prompter-id-migration). The server does not register the conflicting old ID as an alias.
+
 ## Troubleshooting
 
 - **No DMAI nodes:** inspect the ComfyUI console for import errors; check the Python environment and one-level ZIP extraction.
+- **Prompter missing when older DMAI nodes are installed:** update to 0.1.3 or newer, restart ComfyUI and hard-refresh. Search `DMAINodesPrompter` or select **DMAI Prompter** with the **DMAI-NODES** badge. The new node has a `request` output of type `DMAI_PROMPT`.
 - **Missing model:** select the exact catalog entry, including subfolder. Refresh the model list after adding files.
 - **Enhancer unavailable:** install the pinned dependency or choose Clean Base/Manual with `none`.
 - **LoRA has no matching patches:** verify the LoRA family and selected base model; this is deliberately an error.

docs/VALIDATION.md

@@ -1,6 +1,17 @@
-# Validation — 0.1.2 preview
+# Validation — 0.1.3 preview
 
-Checked on 2026-09-28. This release has working ComfyUI registration, CPU contract tests and real local API checks. GPU image generation is still pending.
+Updated on 2026-09-29. This release has working ComfyUI registration, CPU contract tests and real local API checks. GPU image generation is still pending. The coexistence checks below were added for 0.1.3; earlier Gallery, model-picker and connector observations were made on 2026-09-28.
+
+## 0.1.3 coexistence and migration
+
+- Real ComfyUI loader tests load the new extension alongside legacy V1 and Suite-style V3 Prompter fixtures in both orders. Each ID retains its own schema and execution contract. The new extension does not claim `DMAIPrompter`.
+- A running CPU ComfyUI instance loaded the actual older **ComfyUI-DMAI-Suite** and the new package together. `/object_info` contained all seven new nodes and all four Suite nodes. `DMAINodesPrompter` returned `DMAI_PROMPT`; legacy `DMAIPrompter` retained `CONDITIONING, INT, INT, STRING`.
+- In the real Canvas frontend, both Prompters appeared in their separate package categories and rendered their own controls. A saved 0.1.2 DMAI NODES workflow upgraded on load with its five links, 1152x768 dimensions, image count 2, model choices and LoRA strengths intact. A legacy Prompter was added, edited, saved and reloaded alongside it; its original ID and widget format were preserved.
+- JavaScript regressions cover nested serialized subgraphs, named/positional widget formats, invalid or ambiguous signatures, unchanged settings/links and canonical progress tracking. The new frontend mounts only `DMAINodesPrompter`.
+- Eleven Python migration tests cover mixed UI/API graphs, conservative signature checks, invalid links, UTF-8/configuration boundaries, source/output preservation and rejection of legacy nodes before API submission.
+- The new LoRA row/name classes are isolated from the matching selectors found in older DMAI frontend styles.
+
+These checks establish registration, UI coexistence and workflow migration. They do not add GPU inference coverage or certify unrelated third-party extension combinations.
 
 ## Reference environment
 
@@ -14,8 +25,8 @@ Checked on 2026-09-28. This release has working ComfyUI registration, CPU contra
 
 | Check | Evidence |
 | --- | --- |
-| Python suite | 81 tests passed with optional real-Comfy CPU tests enabled, including scoped native progress registry updates and multi-image progress. |
-| JavaScript suite | 53 tests passed: dimensions, exact seeds, ordered manifests, strength edits, mode persistence, sampler overrides, ZIP selection, keyboard containment, Comfy change events, progress presentation, job lifecycle handling, native socket geometry and model-file selection. |
+| Python suite | 99 tests passed with optional real-Comfy CPU tests enabled, including registration coexistence, workflow migration, scoped native progress registry updates and multi-image progress. |
+| JavaScript suite | 64 tests passed: dimensions, exact seeds, ordered manifests, strength edits, mode persistence, sampler overrides, ZIP selection, keyboard containment, Comfy change events, progress presentation, job lifecycle handling, native socket geometry, model-file selection and safe workflow migration. |
 | Node registration | All seven native V3 nodes appear in real `/object_info`. |
 | Runtime choices | Four model profiles, 45 native sampler names and 9 schedulers in the test installation. Extension installations can change these counts. |
 | LoRA loading | Four real CPU comparisons use tiny safetensors, Comfy's file loader, ModelPatcher and LoRA weight calculation. Results match the standard loader and expected low-rank math exactly. |

pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "dmai-nodes"
-version = "0.1.2"
+version = "0.1.3"
 description = "Compact image workflows for ComfyUI: Prompter, ordered LoRAs, Generation Engine and Gallery."
 authors = [{name = "DMAI / ceroomedia"}]
 readme = "README.md"

release.json

@@ -1,11 +1,11 @@
 {
   "name": "DMAI NODES",
-  "version": "0.1.2",
+  "version": "0.1.3",
   "channel": "preview",
   "license": "MIT",
   "comfyui_reference": "0.37.0",
   "frontend_reference": "1.52.7",
-  "nodes": ["DMAIPrompter", "DMAILoRAStack", "DMAIGenerationEngine", "DMAIGallery", "DMAIKreaEnhancer", "DMAIVAEEncode", "DMAIVAEDecode"],
+  "nodes": ["DMAINodesPrompter", "DMAILoRAStack", "DMAIGenerationEngine", "DMAIGallery", "DMAIKreaEnhancer", "DMAIVAEEncode", "DMAIVAEDecode"],
   "model_profiles": ["krea2-turbo", "sdxl-checkpoint", "qwen-image", "flux1-dev"],
   "contains_model_weights": false,
   "gpu_inference_verified": false

tools/build_release.py

@@ -7,7 +7,7 @@ import shutil
 import zipfile
 
 ROOT=Path(__file__).resolve().parents[1]
-VERSION="0.1.2"
+VERSION="0.1.3"
 ROOT_FILES={"__init__.py","README.md","LICENSE","pyproject.toml","requirements.txt","THIRD_PARTY_NOTICES.md","CHANGELOG.md","release.json"}
 DIRECTORIES={"dmai_nodes","web","docs","resources","licenses","workflows"}
 FORBIDDEN={".git","__pycache__",".validation","node_modules","dist"}
@@ -23,7 +23,7 @@ def included_files():
             if path.is_symlink():continue
             parts=path.relative_to(ROOT).parts
             if (len(parts)==1 and parts[0] in ROOT_FILES) or (parts[0] in DIRECTORIES and path.suffix in EXTENSIONS):result.append(path)
-            elif len(parts)==2 and parts[0]=="tools" and path.name in {"run_workflow.py","build_release.py"}:result.append(path)
+            elif len(parts)==2 and parts[0]=="tools" and path.name in {"run_workflow.py","migrate_workflow.py","build_release.py"}:result.append(path)
     return sorted(result,key=lambda item:item.relative_to(ROOT).as_posix())
 
 
@@ -38,7 +38,7 @@ def build():
     path=destination/f"DMAI-NODES-v{VERSION}.zip"
     files=included_files()
     names={item.relative_to(ROOT).as_posix() for item in files}
-    required={"__init__.py","README.md","LICENSE","dmai_nodes/nodes.py","dmai_nodes/engine.py","dmai_nodes/lora.py","dmai_nodes/gallery.py","dmai_nodes/routes.py","web/dmai-nodes.js","requirements.txt","workflows/DMAI-NODES-Krea.json"}
+    required={"__init__.py","README.md","LICENSE","dmai_nodes/nodes.py","dmai_nodes/engine.py","dmai_nodes/lora.py","dmai_nodes/gallery.py","dmai_nodes/routes.py","web/dmai-nodes.js","web/workflow-migration.mjs","tools/migrate_workflow.py","requirements.txt","workflows/DMAI-NODES-Krea.json"}
     missing=required-names
     if missing:raise RuntimeError(f"Missing release files: {missing}")
     with zipfile.ZipFile(path,"w",zipfile.ZIP_DEFLATED,compresslevel=9) as archive:

tools/migrate_workflow.py

@@ -0,0 +1,196 @@
+"""Copy an old DMAI NODES workflow to the conflict-free Prompter ID.
+
+The old Suite's CLIP Prompter and ambiguous nodes are left untouched. This tool
+uses only the Python standard library and never overwrites the input or output.
+"""
+from __future__ import annotations
+
+import argparse
+from copy import deepcopy
+import json
+from pathlib import Path
+
+
+OLD_PROMPTER_ID = "DMAIPrompter"
+PROMPTER_ID = "DMAINodesPrompter"
+PROMPT_KEYS = {"schema_version", "prompt", "negative_prompt", "width", "height", "count"}
+
+
+def _unique_object(pairs):
+    result = {}
+    for key, value in pairs:
+        if key in result:
+            raise ValueError(f"Duplicate JSON key: {key}")
+        result[key] = value
+    return result
+
+
+def _invalid_constant(value):
+    raise ValueError(f"Invalid JSON constant: {value}")
+
+
+def read_json(raw):
+    return json.loads(raw, object_pairs_hook=_unique_object, parse_constant=_invalid_constant)
+
+
+def _prompt_config(raw):
+    """Require the complete v1 request contract, not a coincidental JSON field."""
+    if not isinstance(raw, str) or len(raw.encode("utf-8")) > 128 * 1024:
+        return None
+    try:
+        value = read_json(raw)
+    except (ValueError, TypeError):
+        return None
+    if not isinstance(value, dict) or set(value) != PROMPT_KEYS:
+        return None
+    if type(value["schema_version"]) is not int or value["schema_version"] != 1:
+        return None
+    for key in ("prompt", "negative_prompt"):
+        if not isinstance(value[key], str) or len(value[key]) > 65536 or "\x00" in value[key]:
+            return None
+    for key in ("width", "height"):
+        if type(value[key]) is not int or not 64 <= value[key] <= 8192 or value[key] % 64:
+            return None
+    if value["width"] * value["height"] > 16777216:
+        return None
+    if type(value["count"]) is not int or not 1 <= value["count"] <= 8:
+        return None
+    return value
+
+
+def _is_ui_prompter(node):
+    outputs = node.get("outputs")
+    if not isinstance(outputs, list) or len(outputs) != 1:
+        return False
+    output = outputs[0]
+    if (not isinstance(output, dict) or output.get("name") != "request"
+            or output.get("type") != "DMAI_PROMPT"
+            or ("slot_index" in output and (type(output["slot_index"]) is not int or output["slot_index"] != 0))):
+        return False
+    inputs = node.get("inputs", [])
+    if not isinstance(inputs, list) or any(
+        not isinstance(item, dict) or item.get("name") not in {"config_json", "text"}
+        or item.get("type") != "STRING" for item in inputs
+    ):
+        return False
+    if len({item["name"] for item in inputs}) != len(inputs):
+        return False
+    candidates = []
+    if "widgets_values" in node:
+        values = node["widgets_values"]
+        if not isinstance(values, list) or len(values) != 1:
+            return False
+        candidates.append(_prompt_config(values[0]))
+    if "widgets_values_named" in node:
+        values = node["widgets_values_named"]
+        if not isinstance(values, dict) or set(values) != {"config_json"}:
+            return False
+        candidates.append(_prompt_config(values["config_json"]))
+    return bool(candidates) and all(value is not None and value == candidates[0] for value in candidates)
+
+
+def _link_from(value, node_id):
+    return (isinstance(value, list) and len(value) == 2
+            and type(value[0]) in (str, int) and str(value[0]) == str(node_id))
+
+
+def _is_api_prompter(node_id, node, graph):
+    inputs = node.get("inputs")
+    if (not isinstance(inputs, dict) or set(inputs) - {"config_json", "text"}
+            or _prompt_config(inputs.get("config_json")) is None):
+        return False
+    # API JSON has no typed outputs. A slot-zero request link to our Engine is
+    # the extra evidence that distinguishes this from a legacy Suite node.
+    linked_engine = False
+    for target in graph.values():
+        if not isinstance(target, dict) or not isinstance(target.get("inputs"), dict):
+            continue
+        for name, value in target["inputs"].items():
+            if not _link_from(value, node_id):
+                continue
+            if type(value[1]) is not int or value[1] != 0:
+                return False
+            if target.get("class_type") == "DMAIGenerationEngine" and name == "request":
+                linked_engine = True
+    return linked_engine
+
+
+def migrate_workflow(document):
+    """Return a migrated deep copy plus node paths; never change the caller's data."""
+    if not isinstance(document, dict):
+        raise ValueError("Expected a ComfyUI workflow or API prompt JSON object.")
+    result = deepcopy(document)
+    report = {"migrated": [], "preserved": []}
+
+    def visit_graph(graph, path):
+        if not isinstance(graph, dict):
+            return
+        nodes = graph.get("nodes")
+        if isinstance(nodes, list):
+            for index, node in enumerate(nodes):
+                if not isinstance(node, dict) or node.get("type") != OLD_PROMPTER_ID:
+                    continue
+                location = f"{path}.nodes[{index}]"
+                if _is_ui_prompter(node):
+                    node["type"] = PROMPTER_ID
+                    properties = node.get("properties")
+                    if isinstance(properties, dict) and properties.get("Node name for S&R") == OLD_PROMPTER_ID:
+                        properties["Node name for S&R"] = PROMPTER_ID
+                    report["migrated"].append(location)
+                else:
+                    report["preserved"].append(location)
+        else:
+            for node_id, node in graph.items():
+                if not isinstance(node, dict) or node.get("class_type") != OLD_PROMPTER_ID:
+                    continue
+                location = f"{path}[{node_id!r}]"
+                if _is_api_prompter(node_id, node, graph):
+                    node["class_type"] = PROMPTER_ID
+                    report["migrated"].append(location)
+                else:
+                    report["preserved"].append(location)
+        # Serialized LiteGraph subgraphs live in definitions.subgraphs. Do not
+        # recursively scan arbitrary metadata, prompt text, or node properties.
+        definitions = graph.get("definitions")
+        if isinstance(definitions, dict) and isinstance(definitions.get("subgraphs"), list):
+            for index, subgraph in enumerate(definitions["subgraphs"]):
+                visit_graph(subgraph, f"{path}.definitions.subgraphs[{index}]")
+        for key in ("workflow", "prompt"):
+            if isinstance(graph.get(key), dict) and "class_type" not in graph[key]:
+                visit_graph(graph[key], f"{path}.{key}")
+        extra_data = graph.get("extra_data")
+        if isinstance(extra_data, dict):
+            extra_pnginfo = extra_data.get("extra_pnginfo")
+            if isinstance(extra_pnginfo, dict):
+                visit_graph(extra_pnginfo.get("workflow"), f"{path}.extra_data.extra_pnginfo.workflow")
+
+    visit_graph(result, "$")
+    return result, report
+
+
+def main(argv=None):
+    parser = argparse.ArgumentParser(description=__doc__)
+    parser.add_argument("input", type=Path, help="Existing UI workflow or API prompt JSON")
+    parser.add_argument("--output", required=True, type=Path, help="New JSON filename; must not already exist")
+    args = parser.parse_args(argv)
+    if args.input.resolve() == args.output.resolve():
+        parser.error("Input and output must be different files. The original is always preserved.")
+    if args.output.exists():
+        parser.error("Output already exists. Choose a new filename; existing files are never overwritten.")
+    try:
+        document = read_json(args.input.read_text(encoding="utf-8-sig"))
+        result, report = migrate_workflow(document)
+        data = (json.dumps(result, indent=2, ensure_ascii=False, allow_nan=False) + "\n").encode("utf-8")
+        with args.output.open("xb") as output:
+            output.write(data)
+    except (OSError, ValueError, TypeError) as error:
+        parser.error(str(error))
+    print(f"Saved: {args.output}")
+    print(f"Migrated {len(report['migrated'])} DMAI NODES Prompter node(s).")
+    print(f"Preserved {len(report['preserved'])} legacy or ambiguous DMAIPrompter node(s).")
+    for path in report["preserved"]:
+        print(f"  Unchanged: {path}")
+
+
+if __name__ == "__main__":
+    main()

tools/run_workflow.py

@@ -7,6 +7,11 @@ from urllib.error import HTTPError
 from urllib.request import Request,urlopen
 from uuid import uuid4
 
+try:
+    from .migrate_workflow import PROMPTER_ID, migrate_workflow, read_json
+except ImportError:
+    from migrate_workflow import PROMPTER_ID, migrate_workflow, read_json
+
 
 def call(base,path,data=None):
     body=None if data is None else json.dumps(data).encode()
@@ -29,7 +34,11 @@ def main():
     parser.add_argument("--wait",action="store_true")
     parser.add_argument("--timeout",type=int,default=900)
     args=parser.parse_args()
-    workflow=json.loads(args.workflow.read_text(encoding="utf-8"))
+    workflow, migration=migrate_workflow(read_json(args.workflow.read_text(encoding="utf-8-sig")))
+    if migration["migrated"]:
+        print(f"Migrated {len(migration['migrated'])} old DMAI NODES Prompter ID(s) in memory; the file is unchanged.",flush=True)
+    if not isinstance(workflow.get("1"),dict) or workflow["1"].get("class_type") != PROMPTER_ID:
+        parser.error("This runner requires a DMAI NODES starter API workflow with DMAINodesPrompter at node 1. Legacy Suite or ambiguous Prompters are not converted. Export or use an updated starter API workflow.")
     request=json.loads(workflow["1"]["inputs"]["config_json"])
     request.update(prompt=args.prompt,count=args.count)
     workflow["1"]["inputs"]["config_json"]=json.dumps(request)

web/dmai-nodes.js

@@ -5,10 +5,11 @@ import { Prompter, LoRAStack } from "./inputs.mjs";
 import { Engine } from "./engine.mjs";
 import { Gallery } from "./gallery.mjs";
 import { GenerationProgress } from "./progress.mjs";
+import { PROMPTER_TYPE, migratePreviewPrompters } from "./workflow-migration.mjs";
 
 const controllers = new WeakMap();
 const types = {
-  DMAIPrompter: Prompter,
+  [PROMPTER_TYPE]: Prompter,
   DMAILoRAStack: LoRAStack,
   DMAIGenerationEngine: Engine,
   DMAIGallery: Gallery,
@@ -84,6 +85,7 @@ app.registerExtension({
   },
   nodeCreated: install,
   loadedGraphNode: install,
+  beforeConfigureGraph: migratePreviewPrompters,
   afterConfigureGraph: refreshGraph,
   // Every visible socket is the real Comfy socket. No duplicate connection UI.
 });

web/inputs.mjs

@@ -351,7 +351,7 @@ export class LoRAStack extends Controller {
     list.setAttribute("aria-label", "Ordered LoRA stack");
     let dragged = null;
     this.value.entries.forEach((entry, index) => {
-      const row = el("div", `dmai-lora-row${entry.enabled ? "" : " dmai-off"}`);
+      const row = el("div", `dmai-nodes-lora-row${entry.enabled ? "" : " dmai-off"}`);
       row.dataset.entryId = entry.id;
       const grip = button(`Reorder ${entry.name}; Alt and arrow keys`, "grip");
       grip.classList.add("dmai-grip");
@@ -390,7 +390,7 @@ export class LoRAStack extends Controller {
         dragged = null;
       });
       const copy = el("div", "dmai-lora-copy"),
-        title = el("span", "dmai-lora-name", entry.name.split(/[\\/]/).pop());
+        title = el("span", "dmai-nodes-lora-name", entry.name.split(/[\\/]/).pop());
       title.title = entry.name;
       copy.append(
         title,

web/nodes.css

@@ -361,7 +361,7 @@
   gap: 3px;
   margin-bottom: 8px;
 }
-.dmai-nodes .dmai-lora-row {
+.dmai-nodes .dmai-nodes-lora-row {
   display: grid;
   grid-template-columns: 14px minmax(70px, 1fr) 46px 25px 18px 25px;
   align-items: center;
@@ -369,13 +369,13 @@
   min-height: 65px;
   border-bottom: 1px solid var(--dmai-line);
 }
-.dmai-nodes .dmai-lora-row:last-child {
+.dmai-nodes .dmai-nodes-lora-row:last-child {
   border: 0;
 }
 .dmai-nodes .dmai-lora-copy {
   overflow: hidden;
 }
-.dmai-nodes .dmai-lora-name {
+.dmai-nodes .dmai-nodes-lora-name {
   display: block;
   white-space: nowrap;
   text-overflow: ellipsis;
@@ -393,10 +393,10 @@
   padding: 7px 3px;
   text-align: center;
 }
-.dmai-nodes .dmai-lora-row > .dmai-icon {
+.dmai-nodes .dmai-nodes-lora-row > .dmai-icon {
   width: 25px;
 }
-.dmai-nodes .dmai-lora-row > .dmai-grip {
+.dmai-nodes .dmai-nodes-lora-row > .dmai-grip {
   width: 14px;
   color: #7d8c81;
   cursor: grab;

web/progress.mjs

@@ -1,3 +1,5 @@
+import { PROMPTER_TYPE } from "./workflow-migration.mjs";
+
 // Job identity comes from the submitted API graph, never the current selection.
 const IDLE = Object.freeze({ phase: "idle", percent: 0 });
 const ACTIVE = new Set(["queued", "loading", "sampling", "decoding", "saving"]);
@@ -35,7 +37,7 @@ function connections(entry) {
     const engine = prompt[engineId], link = engine.inputs?.request;
     if (engine.class_type !== "DMAIGenerationEngine" || !Array.isArray(link)) continue;
     const sourceId = String(link[0]);
-    if (prompt[sourceId]?.class_type !== "DMAIPrompter") continue;
+    if (prompt[sourceId]?.class_type !== PROMPTER_TYPE) continue;
     if (!sources.has(sourceId)) sources.set(sourceId, new Set());
     sources.get(sourceId).add(engineId);
   }

web/workflow-migration.mjs

@@ -0,0 +1,76 @@
+import { readPrompt } from "./core.mjs";
+
+export const PROMPTER_TYPE = "DMAINodesPrompter";
+const PREVIEW_PROMPTER_TYPE = "DMAIPrompter";
+const CONFIG_KEYS = ["schema_version", "prompt", "negative_prompt", "width", "height", "count"];
+const isObject = (value) => value !== null && typeof value === "object" && !Array.isArray(value);
+
+function promptConfig(raw) {
+  if (typeof raw !== "string" || new TextEncoder().encode(raw).byteLength > 128 * 1024) return null;
+  try {
+    const value = readPrompt(raw);
+    if (
+      Object.keys(value).length !== CONFIG_KEYS.length ||
+      !CONFIG_KEYS.every((key) => Object.hasOwn(value, key)) ||
+      value.width * value.height > 16777216 ||
+      [value.prompt, value.negative_prompt].some((text) => [...text].length > 65536 || text.includes("\0"))
+    ) return null;
+    return value;
+  } catch { return null; }
+}
+
+// The old Suite also owns DMAIPrompter. Its CLIP/conditioning node must never
+// be aliased or rewritten: only the complete 0.1.x request signature is ours.
+export function isPreviewPrompter(node) {
+  if (!isObject(node) || node.type !== PREVIEW_PROMPTER_TYPE) return false;
+  if (!Array.isArray(node.outputs) || node.outputs.length !== 1) return false;
+  const output = node.outputs[0];
+  if (
+    output?.name !== "request" || output.type !== "DMAI_PROMPT" ||
+    (output.slot_index !== undefined && output.slot_index !== 0)
+  ) return false;
+  const inputs = node.inputs ?? [];
+  if (!Array.isArray(inputs) || inputs.some((input) =>
+    !["text", "config_json"].includes(input?.name) || input.type !== "STRING"
+  ) || new Set(inputs.map((input) => input.name)).size !== inputs.length) return false;
+
+  const candidates = [];
+  if (node.widgets_values !== undefined) {
+    if (!Array.isArray(node.widgets_values) || node.widgets_values.length !== 1) return false;
+    candidates.push(node.widgets_values[0]);
+  }
+  if (node.widgets_values_named !== undefined) {
+    const named = node.widgets_values_named;
+    if (!isObject(named) || Object.keys(named).length !== 1 || !Object.hasOwn(named, "config_json")) return false;
+    candidates.push(named.config_json);
+  }
+  if (!candidates.length) return false;
+  const configs = candidates.map(promptConfig);
+  if (configs.some((config) => !config)) return false;
+  return configs.every((config) => config && CONFIG_KEYS.every((key) => config[key] === configs[0][key]));
+}
+
+// ComfyUI's serialized subgraphs live in definitions.subgraphs, including
+// nested definitions. Runtime node.subgraph and arbitrary metadata are not
+// serialized node collections and must not be rewritten.
+export function migratePreviewPrompters(workflow) {
+  const pending = [workflow], visited = new Set();
+  let migrated = 0;
+  while (pending.length) {
+    const graph = pending.pop();
+    if (!isObject(graph) || visited.has(graph)) continue;
+    visited.add(graph);
+    if (Array.isArray(graph.nodes)) {
+      for (const node of graph.nodes) {
+        if (!isPreviewPrompter(node)) continue;
+        node.type = PROMPTER_TYPE;
+        if (node.properties?.["Node name for S&R"] === PREVIEW_PROMPTER_TYPE)
+          node.properties["Node name for S&R"] = PROMPTER_TYPE;
+        migrated++;
+      }
+    }
+    const subgraphs = graph.definitions?.subgraphs;
+    if (Array.isArray(subgraphs)) pending.push(...subgraphs);
+  }
+  return migrated;
+}

workflows/DMAI-NODES-FLUX.api.json

@@ -1,6 +1,6 @@
 {
   "1": {
-    "class_type": "DMAIPrompter",
+    "class_type": "DMAINodesPrompter",
     "inputs": {
       "config_json": "{\"schema_version\": 1, \"prompt\": \"A sculptural object made of dark stone and translucent green glass, soft studio side light.\", \"negative_prompt\": \"\", \"width\": 832, \"height\": 1024, \"count\": 1}"
     }

workflows/DMAI-NODES-FLUX.json

@@ -4,7 +4,7 @@
   "nodes": [
     {
       "id": 1,
-      "type": "DMAIPrompter",
+      "type": "DMAINodesPrompter",
       "pos": [
         40,
         100
@@ -34,7 +34,7 @@
         }
       ],
       "properties": {
-        "Node name for S&R": "DMAIPrompter"
+        "Node name for S&R": "DMAINodesPrompter"
       },
       "widgets_values": [
         "{\"schema_version\": 1, \"prompt\": \"A sculptural object made of dark stone and translucent green glass, soft studio side light.\", \"negative_prompt\": \"\", \"width\": 832, \"height\": 1024, \"count\": 1}"

workflows/DMAI-NODES-Krea.api.json

@@ -1,6 +1,6 @@
 {
   "1": {
-    "class_type": "DMAIPrompter",
+    "class_type": "DMAINodesPrompter",
     "inputs": {
       "config_json": "{\"schema_version\": 1, \"prompt\": \"A sculptural object made of dark stone and translucent green glass, soft studio side light.\", \"negative_prompt\": \"\", \"width\": 832, \"height\": 1024, \"count\": 1}"
     }

workflows/DMAI-NODES-Krea.json

@@ -4,7 +4,7 @@
   "nodes": [
     {
       "id": 1,
-      "type": "DMAIPrompter",
+      "type": "DMAINodesPrompter",
       "pos": [
         40,
         100
@@ -34,7 +34,7 @@
         }
       ],
       "properties": {
-        "Node name for S&R": "DMAIPrompter"
+        "Node name for S&R": "DMAINodesPrompter"
       },
       "widgets_values": [
         "{\"schema_version\": 1, \"prompt\": \"A sculptural object made of dark stone and translucent green glass, soft studio side light.\", \"negative_prompt\": \"\", \"width\": 832, \"height\": 1024, \"count\": 1}"

workflows/DMAI-NODES-Qwen.api.json

@@ -1,6 +1,6 @@
 {
   "1": {
-    "class_type": "DMAIPrompter",
+    "class_type": "DMAINodesPrompter",
     "inputs": {
       "config_json": "{\"schema_version\": 1, \"prompt\": \"A sculptural object made of dark stone and translucent green glass, soft studio side light.\", \"negative_prompt\": \"\", \"width\": 832, \"height\": 1024, \"count\": 1}"
     }

workflows/DMAI-NODES-Qwen.json

@@ -4,7 +4,7 @@
   "nodes": [
     {
       "id": 1,
-      "type": "DMAIPrompter",
+      "type": "DMAINodesPrompter",
       "pos": [
         40,
         100
@@ -34,7 +34,7 @@
         }
       ],
       "properties": {
-        "Node name for S&R": "DMAIPrompter"
+        "Node name for S&R": "DMAINodesPrompter"
       },
       "widgets_values": [
         "{\"schema_version\": 1, \"prompt\": \"A sculptural object made of dark stone and translucent green glass, soft studio side light.\", \"negative_prompt\": \"\", \"width\": 832, \"height\": 1024, \"count\": 1}"

workflows/DMAI-NODES-SDXL.api.json

@@ -1,6 +1,6 @@
 {
   "1": {
-    "class_type": "DMAIPrompter",
+    "class_type": "DMAINodesPrompter",
     "inputs": {
       "config_json": "{\"schema_version\": 1, \"prompt\": \"A sculptural object made of dark stone and translucent green glass, soft studio side light.\", \"negative_prompt\": \"\", \"width\": 832, \"height\": 1024, \"count\": 1}"
     }

workflows/DMAI-NODES-SDXL.json

@@ -4,7 +4,7 @@
   "nodes": [
     {
       "id": 1,
-      "type": "DMAIPrompter",
+      "type": "DMAINodesPrompter",
       "pos": [
         40,
         100
@@ -34,7 +34,7 @@
         }
       ],
       "properties": {
-        "Node name for S&R": "DMAIPrompter"
+        "Node name for S&R": "DMAINodesPrompter"
       },
       "widgets_values": [
         "{\"schema_version\": 1, \"prompt\": \"A sculptural object made of dark stone and translucent green glass, soft studio side light.\", \"negative_prompt\": \"\", \"width\": 832, \"height\": 1024, \"count\": 1}"