Update backend/agents/puzzle_agent.py

backend/agents/puzzle_agent.py

@@ -304,7 +304,7 @@ STRICT RULES:
 2. Reference the exact mission steps for that level in its goal_description.
 3. CRITICAL: Provide a UNIQUE programming/logic problem in the `story` field for EACH level.
 4. The `title` of each level should match its assigned Theme (e.g., "Bank Heist", "Space Station").
-5. Generate a SPECIFIC `hint` for each level that actually helps them solve the logical problem. Do NOT use generic hints like "look closely".
+5. CRITICAL: Generate a COMPLETELY UNIQUE `hint` for EVERY level. The hint MUST be different for Level 1, Level 2, etc., and must directly reference the specific theme/logic of that exact level! Do NOT repeat hints!
 
 OUTPUT only valid JSON (no markdown):
 {{
@@ -319,6 +319,9 @@ OUTPUT only valid JSON (no markdown):
       "story": "Present the unique logical problem or scenario for this level here...",
       "goal_description": "Step 1: [action] → Step 2: [action] → Reach Exit",
       "hint": "Specific, highly useful hint for this specific puzzle logic",
+      "npc_emoji": "🏦",
+      "item_emoji": "💵",
+      "goal_emoji": "🏁",
       "allowed_blocks": ["move_forward", "turn_left", "turn_right"]
     }}
   ]
@@ -356,16 +359,21 @@ OUTPUT only valid JSON (no markdown):
         }
         diff_key = _diff_norm.get(difficulty.lower(), "easy")
 
-        # Step 1: Pick 5 distinct scenarios matching normalised difficulty
+        # Step 1: Pick 5 completely DISTINCT scenarios matching normalised difficulty
         filtered = [s for s in self.scenarios if s.get("difficulty", "").lower() == diff_key]
-        if not filtered:
+        if len(filtered) < 5:
+            # If not enough filtered, use the entire dataset to guarantee 5 unique scenarios
             filtered = self.scenarios
             
-        # Try to get 5 distinct scenarios, allow duplicates if dataset is too small
-        arc_scenarios = []
-        for _ in range(5):
+        arc_scenarios = random.sample(filtered, min(5, len(filtered)))
+        # Fallback if dataset has less than 5 elements
+        while len(arc_scenarios) < 5:
             arc_scenarios.append(random.choice(filtered) if filtered else {})
 
+        # Ensure each level gets a distinct visual theme color palette
+        palette_keys = list(THEME_PALETTES.keys())
+        random.shuffle(palette_keys)
+
         # Step 2: Pick DAA concept — harder = more complex maze type + larger dim
         concept_map = {
             "easy":   [DAA_CONCEPTS[0], DAA_CONCEPTS[3]],   # collect+reach, sequence
@@ -400,7 +408,7 @@ OUTPUT only valid JSON (no markdown):
             print(f"[PuzzleAgent] AI enrichment failed: {e}. Using fallback.")
             arc = self._build_fallback_arc(arc_scenarios, concept, compiled_grids)
 
-        # Step 5: Inject compiled grids into each level
+        # Step 5: Inject compiled grids and dynamic palettes into each level
         levels = arc.get("levels", [])
         for i, level in enumerate(levels):
             cg = compiled_grids[i] if i < len(compiled_grids) else compiled_grids[-1]
@@ -408,13 +416,23 @@ OUTPUT only valid JSON (no markdown):
             level["maze_rows"]      = cg["rows"]
             level["maze_cols"]      = cg["cols"]
             level["ordered_steps"]  = cg["ordered_steps"]
-            level["theme_palette"]  = cg["palette"]
+            
+            # Assign a distinct color palette
+            palette_key = palette_keys[i % len(palette_keys)]
+            base_palette = THEME_PALETTES.get(palette_key, THEME_PALETTES["default"]).copy()
+            
+            # Inject dynamic AI emojis into the palette so the Flutter UI can read them
+            base_palette["npc_emoji"] = level.get("npc_emoji", "🤵")
+            base_palette["item_emoji"] = level.get("item_emoji", "🔑")
+            base_palette["goal_emoji"] = level.get("goal_emoji", "🚀")
+            
+            level["theme_palette"]  = base_palette
             level["daa_concept"]    = concept["title"]
             level["daa_description"]= concept["description"]
             level["type"]           = "maze"
 
         arc["levels"] = levels
-        arc["theme_palette"] = compiled_grids[0]["palette"]
+        # Remove top-level theme_palette so we don't override the distinct ones later
         return arc
 
     # ─────────────────────────────────────────────────────────
@@ -438,6 +456,9 @@ OUTPUT only valid JSON (no markdown):
                 ),
                 "goal_description": step_str + " → Exit",
                 "hint": "Try planning your path by starting from the end and tracing backwards.",
+                "npc_emoji": "🤵",
+                "item_emoji": "🔑",
+                "goal_emoji": "🚀",
                 "daa_concept": concept["title"],
                 "daa_description": concept["description"],
                 "allowed_blocks": ["move_forward", "turn_left", "turn_right"],