v1.4.2: Hash Vault Label Builder node

New node: HashVaultLabelBuilder (🏷️ Hash Vault Label Builder).
Concatenates up to 4 any-type inputs with a configurable separator into
one STRING for Hash Vault Save's label input. Wire once per workflow
(e.g. style + variant + intensity from Gemini Style Transfer Settings)
and never type a label manually again.

Empty strings, None, and whitespace-only inputs are skipped so partial
wiring produces clean output. Non-string inputs are stringified at join
time.

Solves the repeated-typing pain exposed by running the 77-entry
photographer QA pass. Labels follow the canonical
"Photographer / Variant / intensity" convention automatically.

Author: jeremieLouvaert

README.md

@@ -44,6 +44,24 @@ ComfyUI's native caching often breaks with external API nodes (dynamic timestamp
 
 The Save Result node has an optional `label` input (v1.3.0+). Wire a human-readable string like `"Alec Soth / Songbook / full"` and the Hash Vault Browser will surface it when you need to find a specific past run. The label is stored in the sidecar JSON only, so changing it never breaks existing cache hits.
 
+### Auto-labeling with the Label Builder node (v1.4.2)
+
+Typing labels by hand gets old fast. The `🏷️ Hash Vault Label Builder` node concatenates up to four any-type inputs into one STRING, ready to wire into `Save Result`'s label input. Wire it once per workflow and never type a label again.
+
+For the Gemini Style Transfer pattern:
+- `in_1` ← Settings node's `style` output (e.g. `"Alec Soth"`)
+- `in_2` ← Settings node's `variant` output (e.g. `"Niagara"`)
+- `in_3` ← Settings node's `intensity` output (e.g. `"full"`)
+- `separator` = `" / "`
+- → outputs `"Alec Soth / Niagara / full"`
+
+For a Prompt Studio → Gemini Image Generate pattern:
+- `in_1` ← Prompt Studio's `style` output
+- `in_2` ← the assembled prompt (first line, or a short identifier)
+- → outputs `"Sebastião Salgado / Serra Pelada gold mine workers"`
+
+Empty or None inputs are skipped, so partial wiring stays clean. Non-string inputs are stringified at join time.
+
 ### Migrating pre-v1.3.0 entries
 
 Existing `.pt` files have no sidecar. To backfill:

api_optimizer_nodes.py

@@ -509,6 +509,52 @@ def switch(self, is_cached, cached_data=None, api_data=None):
             print("🔀 [Lazy Switch] Cache Miss routed! API was executed.")
             return (api_data,)
 
+# ------------------------------------------------------------------------
+# NODE 5: Hash Vault Label Builder (v1.4.2)
+# ------------------------------------------------------------------------
+class HashVaultLabelBuilder:
+    """Concatenate up to 4 any-type inputs into one STRING for Hash Vault Save's label.
+
+    Wire style/variant/intensity (or prompt/model/params) once per workflow and never
+    manually type a label again. Empty or None inputs are skipped so the output stays
+    clean when only some slots are wired.
+    """
+
+    @classmethod
+    def INPUT_TYPES(s):
+        return {
+            "required": {
+                "separator": ("STRING", {
+                    "default": " / ",
+                    "multiline": False,
+                    "tooltip": "Separator placed between each non-empty input. Defaults to ' / '."
+                }),
+            },
+            "optional": {
+                "in_1": (any_type, {"tooltip": "First input. Any type — stringified at join time. None or empty strings are skipped."}),
+                "in_2": (any_type, {"tooltip": "Second input."}),
+                "in_3": (any_type, {"tooltip": "Third input."}),
+                "in_4": (any_type, {"tooltip": "Fourth input."}),
+            }
+        }
+
+    RETURN_TYPES = ("STRING",)
+    RETURN_NAMES = ("label",)
+    FUNCTION = "build"
+    CATEGORY = "API Optimization"
+
+    def build(self, separator, in_1=None, in_2=None, in_3=None, in_4=None):
+        parts = []
+        for value in (in_1, in_2, in_3, in_4):
+            if value is None:
+                continue
+            text = str(value).strip()
+            if not text:
+                continue
+            parts.append(text)
+        return (separator.join(parts),)
+
+
 # ------------------------------------------------------------------------
 # MAPPINGS: Registering the nodes with ComfyUI
 # ------------------------------------------------------------------------
@@ -517,11 +563,13 @@ def switch(self, is_cached, cached_data=None, api_data=None):
     "DeterministicHashVault": DeterministicHashVault,
     "HashVaultSave": HashVaultSave,
     "LazyAPISwitch": LazyAPISwitch,
+    "HashVaultLabelBuilder": HashVaultLabelBuilder,
 }
 
 NODE_DISPLAY_NAME_MAPPINGS = {
     "APICostTracker": "💰 API Cost & Quota Tracker",
     "DeterministicHashVault": "🔍 Hash Vault (Check Cache)",
     "HashVaultSave": "💾 Hash Vault (Save API Result)",
     "LazyAPISwitch": "🔀 Lazy API Switch (Bypass)",
+    "HashVaultLabelBuilder": "🏷️ Hash Vault Label Builder",
 }

pyproject.toml

@@ -1,7 +1,7 @@
 [project]
 name = "comfyui-api-optimizer"
 description = "API cost tracking, deterministic hash caching, and lazy execution bypass for cloud API workflows"
-version = "1.4.1"
+version = "1.4.2"
 license = { file = "LICENSE" }
 
 [project.urls]