Add compiled prompt reference output pairs

README.md

@@ -58,10 +58,10 @@
 
 - `Dumas H3 Prompt Curator`
   - Inputs: `action_prompt`, `anatomy_guard`, `subject_count_guard`, optional `anchor`, optional `soundscape`, optional `bgm`, optional `ref_1` through `ref_9`
-  - Outputs: `prompt`, `ref_image_1` through `ref_image_9`, `reference_count`, `debug`, `anchor`, `sounds`, `bgm`, `original_ref_1` through `original_ref_9`, `reference_description`, `original_ref_description_1` through `original_ref_description_9`
+  - Outputs: `prompt`, `ref_image_1` through `ref_image_9`, `reference_count`, `debug`, `anchor`, `sounds`, `bgm`, `original_ref_1` through `original_ref_9`, `reference_description`, `original_ref_description_1` through `original_ref_description_9`, `compiled_ref_image_1` through `compiled_ref_image_9`, `compiled_ref_description_1` through `compiled_ref_description_9`
   - Builds one standalone MiniMax H3 prompt from your final action text plus structured character/location references.
   - The action text can mention references by character/location name, alias, `<Picture N>`, or `<refN>`. Only mentioned references are emitted, and the output images are compacted/renumbered so skipped inputs do not leave gaps.
-  - Extra component outputs expose the cleaned anchor, sounds, BGM, selected structured references in compacted order, the compiled reference-description block used inside the prompt, and one individual description per selected reference.
+  - Extra component outputs expose the cleaned anchor, sounds, BGM, selected structured references in compacted order, the compiled reference-description block used inside the prompt, and plain image/compiled-description socket pairs for each selected reference.
   - Adds curated reference context, anatomy guard text, optional subject-count guard text, anchor/style text, `overall_soundscape:` text, and `background_music:` text while respecting MiniMax H3's reference-generation shape: one prompt plus up to nine reference images.
 
 - `Dumas H3 Shot Length`

dumas_image_nodes.py

@@ -1304,6 +1304,8 @@ def curate_h3_prompt(
         *selected_refs[:_H3_PROMPT_REF_SLOTS],
         reference_description,
         *individual_reference_descriptions[:_H3_PROMPT_REF_SLOTS],
+        *images[:_H3_PROMPT_REF_SLOTS],
+        *individual_reference_descriptions[:_H3_PROMPT_REF_SLOTS],
     )
 
 
@@ -2698,6 +2700,8 @@ class DumasH3PromptCuratorNode:
         + (_REFERENCE_TYPE,) * _H3_PROMPT_REF_SLOTS
         + ("STRING",)
         + ("STRING",) * _H3_PROMPT_REF_SLOTS
+        + ("IMAGE",) * _H3_PROMPT_REF_SLOTS
+        + ("STRING",) * _H3_PROMPT_REF_SLOTS
     )
     RETURN_NAMES = (
         "prompt",
@@ -2734,6 +2738,24 @@ class DumasH3PromptCuratorNode:
         "original_ref_description_7",
         "original_ref_description_8",
         "original_ref_description_9",
+        "compiled_ref_image_1",
+        "compiled_ref_image_2",
+        "compiled_ref_image_3",
+        "compiled_ref_image_4",
+        "compiled_ref_image_5",
+        "compiled_ref_image_6",
+        "compiled_ref_image_7",
+        "compiled_ref_image_8",
+        "compiled_ref_image_9",
+        "compiled_ref_description_1",
+        "compiled_ref_description_2",
+        "compiled_ref_description_3",
+        "compiled_ref_description_4",
+        "compiled_ref_description_5",
+        "compiled_ref_description_6",
+        "compiled_ref_description_7",
+        "compiled_ref_description_8",
+        "compiled_ref_description_9",
     )
     FUNCTION = "curate_prompt"
     CATEGORY = "Dumas/MiniMax"

tests/test_dumas_image_nodes.py

@@ -515,6 +515,14 @@ class DumasImageNodeTests(unittest.TestCase):
         self.assertIn("<Picture 2> Coffee Shop", result[26])
         self.assertIn("Location context for <Picture 2> Coffee Shop", result[26])
         self.assertEqual(result[27], "")
+        self.assertIs(result[34], dave_image)
+        self.assertIs(result[35], cafe_image)
+        self.assertIsNone(result[36])
+        self.assertIn("<Picture 1> Dave", result[43])
+        self.assertNotIn("<Picture 2> Coffee Shop", result[43])
+        self.assertIn("<Picture 2> Coffee Shop", result[44])
+        self.assertIn("Location context for <Picture 2> Coffee Shop", result[44])
+        self.assertEqual(result[45], "")
 
     def test_h3_prompt_curator_renumbers_explicit_reference_tags(self):
         node = self.image_nodes.DumasH3PromptCuratorNode()
@@ -652,7 +660,7 @@ class DumasImageNodeTests(unittest.TestCase):
 
     def test_h3_prompt_curator_uses_documented_reference_limits(self):
         node = self.image_nodes.DumasH3PromptCuratorNode()
-        self.assertEqual(len(node.RETURN_TYPES), 34)
+        self.assertEqual(len(node.RETURN_TYPES), 52)
         self.assertEqual(node.RETURN_NAMES[1:10], tuple(f"ref_image_{i}" for i in range(1, 10)))
         self.assertEqual(node.RETURN_NAMES[12:15], ("anchor", "sounds", "bgm"))
         self.assertEqual(node.RETURN_NAMES[15:24], tuple(f"original_ref_{i}" for i in range(1, 10)))
@@ -661,6 +669,11 @@ class DumasImageNodeTests(unittest.TestCase):
             node.RETURN_NAMES[25:34],
             tuple(f"original_ref_description_{i}" for i in range(1, 10)),
         )
+        self.assertEqual(node.RETURN_NAMES[34:43], tuple(f"compiled_ref_image_{i}" for i in range(1, 10)))
+        self.assertEqual(
+            node.RETURN_NAMES[43:52],
+            tuple(f"compiled_ref_description_{i}" for i in range(1, 10)),
+        )
 
     def test_normalize_reference_upgrades_generic_summary_with_socket_picture_id(self):
         image = FakeTensorBatch()