fix

media/audio/explain_1112505a6701429cb241d131a88bf709.wav

@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:0f7aae706a5bc1c25e9cf61ddc970ab3d0454650c14a936c7da051556c057091
+size 1951916

media/audio/explain_5c2a7427d1f14a2aa9fa9e59bb1ad603.wav

@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:af65a4273dbbcb6aa004215de1f58b1fd964bcdb1df04ce10a0a872a920b29c5
+size 634956

media/audio/explain_975ae1b5996743f6b76b5016f17056de.wav

@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:7c54cd66b876ad6ab7ad9b7420fd38e2aa80e625e5d34be2fb3ef9d96461ddff
+size 503372

media/audio/explain_ca92720c882d4926973973aa4b9f2316.wav

@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:14a428d11bba10b2f51c72826a9339dde62189153473796269b0fd7a09f27c54
+size 193612

media/audio/explain_cc24a21b0b374e50bc8afbf73a7398c4.wav

@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:a1dff985cf893840190f1f1e8229e99c80ed5651035f820c1590e39690fc009f
+size 175692

media/audio/explain_dd70fb52325d44fc84cde7c1c9215232.wav

@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:e37bd2a66186f0e2ca5ee4a02b0a9b63977af13f9bf5bb32f006f8a2066edcf7
+size 470092

media/audio/synth_22ebf1e3b9404b34a41b2fdc2c691adb.wav

@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:7137826339f483af77865b9dfd96c2386311e5cfcc52ca5990a011fabdd12fab
+size 1287340

media/audio/synth_2757240115da4ba3a9aa1286aee57db9.wav

@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:675814fca44682416fa92128edc0b7637c3afdeeea7043f7a167ce36f4ac4a01
+size 676972

media/audio/synth_4965badeb7da43ffac0c3a7af781ab0f.wav

@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:bab5cb8d0e45d587f484120aaad8eefb100a757ab3c91b8909afedbc199ce106
+size 157772

media/audio/synth_7bccf943f0b24880b77aa038b38f8bf1.wav

@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:2914d7c32525eaf3ab30bedbca0a1dc3a9d1145dad34a0c45eb13f28d67f3d7e
+size 465484

media/audio/synth_ee1e3e992d6641b9a06d214e0e67ea92.wav

@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:8747b294606c0766d55d6d24adc2c5ace29259c1f1969bae781f92e25dfb456f
+size 505932

ragg/app.py

@@ -332,6 +332,115 @@ def rag_generate_questions():
 
 
 # @rag_bp.route("/explain-grammar", methods=["POST", "OPTIONS"])
+# @rag_bp.route("/explain-grammar", methods=["POST", "OPTIONS"])
+# def rag_explain_grammar():
+#     if request.method == "OPTIONS":
+#         return ("", 204)
+
+#     data = request.get_json(force=True) or {}
+
+#     # --- Extract username and db_level ---
+#     username = extract_username_from_request(request)
+#     db_level = user_to_db_level(username)
+
+#     # --- MAIN BODY (your preferred structure) ---
+#     body = ExplainBody(
+#         question=(data.get("question") or "").strip(),
+#         model=data.get("model", "gpt-4o-mini"),
+#         db_level=db_level,
+#         source_ids=data.get("source_ids") or []
+#     )
+
+#     # --- 1) Run LLM / RAG explanation ---
+#     result_raw = llm_explain(body)
+
+#     # --- 2) Normalize + extract answer safely ---
+#     result_dict = None
+#     answer_text = ""
+#     try:
+#         if isinstance(result_raw, dict):
+#             result_dict = dict(result_raw)
+#         elif hasattr(result_raw, "model_dump"):
+#             result_dict = result_raw.model_dump()
+#         elif hasattr(result_raw, "dict"):
+#             result_dict = result_raw.dict()
+#         elif isinstance(result_raw, str):
+#             result_dict = {"answer": result_raw}
+#         else:
+#             result_dict = {"answer": str(result_raw)}
+
+#         answer_text = (
+#             result_dict.get("answer")
+#             or result_dict.get("response")
+#             or result_dict.get("text")
+#             or ""
+#         ).strip()
+#     except Exception as e:
+#         current_app.logger.exception("Failed to normalize llm_explain result: %s", e)
+#         return jsonify({"error": "Internal error normalizing LLM response"}), 500
+
+#     # --- 3) Optional: synthesize TTS audio ---
+#     try:
+#         if data.get("synthesize_audio"):
+#             try:
+#                 out_name = f"explain_{uuid.uuid4().hex}.wav"
+#                 wav_path = xtts_speak_to_file(
+#                     text=answer_text or result_dict.get("answer", ""),
+#                     out_file=AUDIO_DIR / out_name,
+#                     reference_dir=XTTS_REF_DIR,
+#                     reference_files=None,
+#                     language=data.get("language", "en"),
+#                 )
+#                 # Local: serve from /rag/audio/*
+#                 if "localhost" in request.host_url or "127.0.0.1" in request.host_url:
+#                     base = request.host_url.rstrip("/")
+#                     result_dict["audio_url"] = f"{base}/rag/audio/{wav_path.name}"
+#                 else:
+#                     # Deployed: try S3 first; fallback to public SPACE_URL if set
+#                     s3_url = _upload_to_s3(str(wav_path))
+#                     if s3_url:
+#                         result_dict["audio_url"] = s3_url
+#                     else:
+#                         base = os.getenv("SPACE_URL", "https://pykara-py-learn-backend.hf.space")
+#                         result_dict["audio_url"] = f"{base}/rag/audio/{wav_path.name}"
+#             except FileNotFoundError as e:
+#                 current_app.logger.error("XTTS reference audio missing: %s", e)
+#             except Exception as e:
+#                 current_app.logger.exception("XTTS synthesis during explain-grammar failed: %s", e)
+#     except Exception:
+#         current_app.logger.exception("Unexpected error while attempting inline synthesis")
+
+#     # --- 4) Optional: synthesize video (D-ID) ---
+#     try:
+#         if data.get("synthesize_video"):
+#             if not DID_API_KEY or not DID_SOURCE_IMAGE_URL:
+#                 current_app.logger.error("D-ID not configured for inline explain-grammar video synthesis")
+#             else:
+#                 try:
+#                     talk_id, err = _did_create_talk(answer_text or result_dict.get("answer", ""))
+#                     if err:
+#                         current_app.logger.error(
+#                             "D-ID create error during explain-grammar: %s",
+#                             err[0] if isinstance(err, tuple) else err,
+#                         )
+#                     else:
+#                         video_url, err = _did_poll_talk(talk_id, timeout_sec=120, interval_sec=2.0)
+#                         if err:
+#                             current_app.logger.error(
+#                                 "D-ID poll error during explain-grammar: %s",
+#                                 err[0] if isinstance(err, tuple) else err,
+#                             )
+#                         else:
+#                             if video_url:
+#                                 result_dict["video_url"] = video_url
+#                 except Exception as e:
+#                     current_app.logger.exception("D-ID inline synthesis failed during explain-grammar: %s", e)
+#     except Exception:
+#         current_app.logger.exception("Unexpected error while attempting inline video synthesis")
+
+#     # --- Final response ---
+#     return jsonify(result_dict), 200
+
 @rag_bp.route("/explain-grammar", methods=["POST", "OPTIONS"])
 def rag_explain_grammar():
     if request.method == "OPTIONS":
@@ -391,18 +500,8 @@ def rag_explain_grammar():
                     reference_files=None,
                     language=data.get("language", "en"),
                 )
-                # Local: serve from /rag/audio/*
-                if "localhost" in request.host_url or "127.0.0.1" in request.host_url:
-                    base = request.host_url.rstrip("/")
-                    result_dict["audio_url"] = f"{base}/rag/audio/{wav_path.name}"
-                else:
-                    # Deployed: try S3 first; fallback to public SPACE_URL if set
-                    s3_url = _upload_to_s3(str(wav_path))
-                    if s3_url:
-                        result_dict["audio_url"] = s3_url
-                    else:
-                        base = os.getenv("SPACE_URL", "https://pykara-py-learn-backend.hf.space")
-                        result_dict["audio_url"] = f"{base}/rag/audio/{wav_path.name}"
+                base = request.host_url.rstrip("/")
+                result_dict["audio_url"] = f"{base}/rag/audio/{wav_path.name}"
             except FileNotFoundError as e:
                 current_app.logger.error("XTTS reference audio missing: %s", e)
             except Exception as e: