Allow V3.9 sampler to consume RefMods directly

This commit is contained in:
2026-10-20 15:14:08 +00:00
parent cb9c3f339d
commit 1a305e6934
3 changed files with 122 additions and 0 deletions
+94
View File
@@ -83,6 +83,8 @@ def _namespace_class(node_class, *, node_id, category, display_name):
# constructing the node search index.
namespaced.CATEGORY = category
namespaced.NODE_CATEGORY = category
if node_id == "DumasH3Continuum_H3ContinuumSamplerV39":
namespaced = _add_direct_refmod_input(namespaced)
namespaced.__module__ = __name__
namespaced.__qualname__ = node_class.__qualname__
namespaced.__name__ = node_class.__name__
@@ -90,6 +92,98 @@ def _namespace_class(node_class, *, node_id, category, display_name):
return namespaced
def _add_direct_refmod_input(node_class):
"""Add the DUMAS direct RefMod path to the vendored V3.9 sampler.
Continuum's normal image-reference bundle remains untouched. When a
RefMod bundle is connected, the same model-scoped OUTER_SAMPLE bridge used
by the maintained RefMod pack is attached to a cloned model for this run.
This keeps RefMods on the native H3 ref2va path and avoids global state.
"""
original_input_types = node_class.INPUT_TYPES
@classmethod
def INPUT_TYPES(cls):
schema = original_input_types()
schema = {name: dict(value) for name, value in schema.items()}
optional = dict(schema.get("optional", {}))
optional["refmods"] = (
"H3_REF_MODS",
{
"display_name": "RefMods (Optional)",
"tooltip": (
"Optional MiniMax H3 RefMod bundle. RefMods are injected directly "
"into this sampler for every generated chunk."
),
},
)
optional["refmod_retention"] = (
"FLOAT",
{
"default": 1.0,
"min": 0.0,
"max": 1.0,
"step": 0.01,
"display": "number",
"display_name": "RefMod Retention",
"tooltip": "Master RefMod strength. 1.0 preserves the selected bundle fully.",
},
)
optional["refmod_max_total_tokens"] = (
"INT",
{
"default": 0,
"min": 0,
"max": 1048576,
"step": 1,
"display_name": "RefMod Token Budget",
"tooltip": "0 uses the RefMod bundle's normal budget; otherwise enforce this maximum.",
},
)
schema["optional"] = optional
return schema
def run(self, refmods=None, refmod_retention=1.0,
refmod_max_total_tokens=0, **kwargs):
if refmods:
model = kwargs.get("model")
if model is None:
raise ValueError(
"DUMAS H3 Continuum Sampler V3.9 requires a model when RefMods are connected."
)
try:
pack = importlib.import_module(
f"{__package__}.vendor.dumas_minimax_h3_refmod.nodes"
if __package__ else "vendor.dumas_minimax_h3_refmod.nodes"
)
bridge = importlib.import_module(
f"{__package__}.vendor.dumas_minimax_h3_refmod.continuum_bridge"
if __package__ else "vendor.dumas_minimax_h3_refmod.continuum_bridge"
)
blocks = pack._ref_blocks(
refmods,
refmod_retention,
seed=-1,
scramble_mode="shuffle",
max_total_tokens=int(refmod_max_total_tokens),
)
kwargs["model"] = bridge.attach(model, blocks, enabled=True)
print(
"[DUMAS H3 Continuum Sampler V3.9] direct RefMods active "
f"({len(blocks)} block(s))"
)
except Exception as exc:
raise RuntimeError(
"Unable to attach RefMods directly to DUMAS H3 Continuum "
f"Sampler V3.9: {exc}"
) from exc
return super(node_class, self).run(**kwargs)
node_class.INPUT_TYPES = INPUT_TYPES
node_class.run = run
return node_class
def _namespaced_mappings():
mappings = {}
display = {}