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
+8
View File
@@ -138,6 +138,14 @@ behaviour. The picker shows matching preview images when present.
The maintained MiniMax H3 RefMod reader must be installed alongside DUMAS;
DUMAS does not duplicate that reader or override its node IDs.
The vendored `DUMAS H3 Continuum · H3 Continuum Sampler V3.9` also exposes an
optional `RefMods (Optional)` socket. Connect the `H3_REF_MODS` output from a
RefMod loader or creator directly to that socket; the sampler clones the model
and attaches the RefMod bridge only for that run. `RefMod Retention` and
`RefMod Token Budget` are available beside the socket, while ordinary image
reference routing remains unchanged. The separate model bridge node is still
available for V3.8 and other samplers.
### DUMAS H3 RefMods to Continuum
`DUMAS H3 RefMods to Continuum` is the minimal compatibility bridge for the
+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 = {}
+20
View File
@@ -21,7 +21,27 @@ class _ModernNode:
return _Schema("UpstreamModern", "Upstream", "Modern")
class _SamplerBase:
@classmethod
def INPUT_TYPES(cls):
return {"required": {"model": ("MODEL",)}, "optional": {}}
def run(self, **kwargs):
return kwargs
class _Sampler(_SamplerBase):
pass
class VendoredNamespaceTests(unittest.TestCase):
def test_v39_sampler_exposes_direct_refmod_socket(self):
sampler = vendored._add_direct_refmod_input(_Sampler)
inputs = sampler.INPUT_TYPES()
self.assertEqual(inputs["optional"]["refmods"][0], "H3_REF_MODS")
self.assertIn("refmod_retention", inputs["optional"])
self.assertIn("refmod_max_total_tokens", inputs["optional"])
def test_legacy_and_modern_nodes_get_distinct_dumas_identity(self):
original_packages = vendored._PACKAGES
original_loader = vendored._load_pack