Release H3 Continuum V3.2.1
This commit is contained in:
@@ -0,0 +1,151 @@
|
||||
"""Deterministic, fail-closed fingerprints for ComfyUI upstream loader graphs."""
|
||||
|
||||
from __future__ import annotations
|
||||
|
||||
import hashlib
|
||||
import json
|
||||
from typing import Any
|
||||
|
||||
|
||||
GRAPH_CONTRACT_VERSION = 1
|
||||
|
||||
# Keep this deliberately explicit. New loader/patch nodes must be audited before
|
||||
# their saved chunks can be resumed automatically.
|
||||
_KNOWN_MODEL_NODES = {
|
||||
"UNETLoader",
|
||||
"LoraLoader",
|
||||
"LoraLoaderModelOnly",
|
||||
"Power Lora Loader (rgthree)",
|
||||
"PathchSageAttentionKJ",
|
||||
"PatchSageAttentionKJ",
|
||||
"SpectrumApplyMiniMaxH3",
|
||||
"MiniMaxH3MemoryEfficientSageAttention",
|
||||
"MiniMaxH3MemoryEfficientSageAttentionPatch",
|
||||
}
|
||||
_KNOWN_CLIP_NODES = {"CLIPLoader", "DualCLIPLoader", "TripleCLIPLoader"}
|
||||
_KNOWN_VAE_NODES = {"VAELoader"}
|
||||
_KNOWN_SHARED_NODES = {
|
||||
"Reroute",
|
||||
"Any Switch (rgthree)",
|
||||
}
|
||||
|
||||
|
||||
def _canonical(value: Any) -> str:
|
||||
return json.dumps(value, sort_keys=True, separators=(",", ":"), ensure_ascii=True)
|
||||
|
||||
|
||||
def _sha256(value: Any) -> str:
|
||||
return hashlib.sha256(_canonical(value).encode("utf-8")).hexdigest()
|
||||
|
||||
|
||||
def _literal(value: Any) -> tuple[Any, bool]:
|
||||
if value is None or isinstance(value, (bool, int, float, str)):
|
||||
return value, True
|
||||
if isinstance(value, (list, tuple)):
|
||||
result = []
|
||||
safe = True
|
||||
for item in value:
|
||||
rendered, item_safe = _literal(item)
|
||||
result.append(rendered)
|
||||
safe = safe and item_safe
|
||||
return result, safe
|
||||
if isinstance(value, dict):
|
||||
result = {}
|
||||
safe = True
|
||||
for key in sorted(value, key=str):
|
||||
rendered, item_safe = _literal(value[key])
|
||||
result[str(key)] = rendered
|
||||
safe = safe and item_safe
|
||||
return result, safe
|
||||
return {"type": f"{type(value).__module__}.{type(value).__qualname__}"}, False
|
||||
|
||||
|
||||
def _node(prompt: dict[str, Any], node_id: str, *, allowed: set[str], stack: set[str]) -> tuple[dict[str, Any], bool, list[str]]:
|
||||
if node_id in stack:
|
||||
return {"node_id": node_id, "error": "cycle"}, False, [f"upstream graph contains a cycle at node {node_id}"]
|
||||
raw = prompt.get(str(node_id))
|
||||
if not isinstance(raw, dict):
|
||||
return {"node_id": node_id, "error": "missing"}, False, [f"upstream node {node_id} is missing"]
|
||||
class_type = str(raw.get("class_type", ""))
|
||||
safe = class_type in allowed or class_type in _KNOWN_SHARED_NODES
|
||||
reasons = [] if safe else [f"unknown upstream node class: {class_type or '<missing>'}"]
|
||||
inputs = raw.get("inputs") or {}
|
||||
if not isinstance(inputs, dict):
|
||||
return {"node_id": node_id, "class_type": class_type, "error": "invalid inputs"}, False, reasons + [f"upstream node {node_id} inputs are invalid"]
|
||||
rendered_inputs: dict[str, Any] = {}
|
||||
next_stack = set(stack)
|
||||
next_stack.add(node_id)
|
||||
for name in sorted(inputs):
|
||||
value = inputs[name]
|
||||
if (
|
||||
isinstance(value, (list, tuple))
|
||||
and len(value) == 2
|
||||
and isinstance(value[0], (str, int))
|
||||
and isinstance(value[1], int)
|
||||
and str(value[0]) in prompt
|
||||
):
|
||||
child, child_safe, child_reasons = _node(
|
||||
prompt, str(value[0]), allowed=allowed, stack=next_stack
|
||||
)
|
||||
rendered_inputs[str(name)] = {"output": int(value[1]), "node": child}
|
||||
safe = safe and child_safe
|
||||
reasons.extend(child_reasons)
|
||||
else:
|
||||
rendered, literal_safe = _literal(value)
|
||||
rendered_inputs[str(name)] = rendered
|
||||
safe = safe and literal_safe
|
||||
if not literal_safe:
|
||||
reasons.append(f"upstream node {node_id}.{name} is not serializable")
|
||||
return {
|
||||
"node_id": str(node_id),
|
||||
"class_type": class_type,
|
||||
"inputs": rendered_inputs,
|
||||
}, safe, reasons
|
||||
|
||||
|
||||
def build_upstream_graph_contract(
|
||||
prompt: Any, unique_id: Any, *, require_video_vae: bool
|
||||
) -> tuple[dict[str, Any], bool, list[str]]:
|
||||
"""Fingerprint MODEL/CLIP/VAE routes feeding the Continuum sampler."""
|
||||
if not isinstance(prompt, dict):
|
||||
return {"version": GRAPH_CONTRACT_VERSION}, False, ["ComfyUI PROMPT graph is unavailable"]
|
||||
node_id = str(unique_id)
|
||||
sampler_node = prompt.get(node_id)
|
||||
if not isinstance(sampler_node, dict):
|
||||
return {"version": GRAPH_CONTRACT_VERSION}, False, ["Continuum sampler node is absent from PROMPT graph"]
|
||||
inputs = sampler_node.get("inputs") or {}
|
||||
routes: dict[str, Any] = {}
|
||||
safe = True
|
||||
reasons: list[str] = []
|
||||
specs = (
|
||||
("model", _KNOWN_MODEL_NODES, True),
|
||||
("clip", _KNOWN_CLIP_NODES, True),
|
||||
("video_vae", _KNOWN_VAE_NODES, bool(require_video_vae)),
|
||||
)
|
||||
for name, allowed, required in specs:
|
||||
if not required:
|
||||
continue
|
||||
link = inputs.get(name)
|
||||
if not (
|
||||
isinstance(link, (list, tuple))
|
||||
and len(link) == 2
|
||||
and isinstance(link[0], (str, int))
|
||||
and isinstance(link[1], int)
|
||||
):
|
||||
routes[name] = {"error": "input is not connected"}
|
||||
safe = False
|
||||
reasons.append(f"{name} upstream connection is unavailable")
|
||||
continue
|
||||
route, route_safe, route_reasons = _node(
|
||||
prompt, str(link[0]), allowed=allowed, stack={node_id}
|
||||
)
|
||||
routes[name] = {"output": int(link[1]), "node": route}
|
||||
safe = safe and route_safe
|
||||
reasons.extend(route_reasons)
|
||||
descriptor = {
|
||||
"version": GRAPH_CONTRACT_VERSION,
|
||||
"sampler_class_type": str(sampler_node.get("class_type", "")),
|
||||
"routes": routes,
|
||||
}
|
||||
descriptor["sha256"] = _sha256(descriptor)
|
||||
return descriptor, safe, list(dict.fromkeys(reasons))
|
||||
Reference in New Issue
Block a user