Update conversation_logic.py

conversation_logic.py

@@ -1,3 +1,4 @@
+# conversation_logic.py
 from __future__ import annotations
 
 import re
@@ -317,6 +318,11 @@ def is_explainer_request(text: str) -> bool:
         "can you explain",
         "explain how",
         "explain why",
+        "break this down",
+        "question breakdown",
+        "what should i identify first",
+        "what do i do first",
+        "what is the first move",
     ]
 
     return any(p in t for p in explainer_signals)
@@ -816,6 +822,48 @@ def _pick_teaching_line(
     return best_line
 
 
+def _safe_meta_list(items: Any) -> List[str]:
+    if not items:
+        return []
+    if isinstance(items, list):
+        return [str(x).strip() for x in items if str(x).strip()]
+    if isinstance(items, tuple):
+        return [str(x).strip() for x in items if str(x).strip()]
+    if isinstance(items, str):
+        text = items.strip()
+        return [text] if text else []
+    return []
+
+
+def _safe_meta_text(value: Any) -> Optional[str]:
+    if value is None:
+        return None
+    text = str(value).strip()
+    return text or None
+
+
+def _extract_explainer_scaffold(explainer_result: Any) -> Dict[str, Any]:
+    scaffold = getattr(explainer_result, "scaffold", None)
+
+    if scaffold is None:
+        return {}
+
+    return {
+        "concept": _safe_meta_text(getattr(scaffold, "concept", None)),
+        "ask": _safe_meta_text(getattr(scaffold, "ask", None)),
+        "givens": _safe_meta_list(getattr(scaffold, "givens", [])),
+        "target": _safe_meta_text(getattr(scaffold, "target", None)),
+        "setup_actions": _safe_meta_list(getattr(scaffold, "setup_actions", [])),
+        "intermediate_steps": _safe_meta_list(getattr(scaffold, "intermediate_steps", [])),
+        "first_move": _safe_meta_text(getattr(scaffold, "first_move", None)),
+        "next_hint": _safe_meta_text(getattr(scaffold, "next_hint", None)),
+        "common_traps": _safe_meta_list(getattr(scaffold, "common_traps", [])),
+        "variables_to_define": _safe_meta_list(getattr(scaffold, "variables_to_define", [])),
+        "equations_to_form": _safe_meta_list(getattr(scaffold, "equations_to_form", [])),
+        "answer_hidden": bool(getattr(scaffold, "answer_hidden", True)),
+    }
+
+
 class ConversationEngine:
     def __init__(
         self,
@@ -889,6 +937,8 @@ class ConversationEngine:
                     transparency=transparency,
                 )
 
+                scaffold_meta = _extract_explainer_scaffold(explainer_result)
+
                 result.domain = "quant" if is_quant else "general"
                 result.solved = False
                 result.help_mode = "explain"
@@ -907,6 +957,13 @@ class ConversationEngine:
                     "question_type": question_type,
                     "classified_topic": question_topic,
                     "explainer_used": True,
+                    "bridge_ready": bool(getattr(explainer_result, "meta", {}).get("bridge_ready", False)),
+                    "hint_style": getattr(explainer_result, "meta", {}).get("hint_style"),
+                    "explainer_summary": getattr(explainer_result, "summary", None),
+                    "explainer_teaching_points": _safe_meta_list(
+                        getattr(explainer_result, "teaching_points", [])
+                    ),
+                    "scaffold": scaffold_meta,
                 }
                 return result