fix: harden Dream QA agent path

app.py

@@ -1,5 +1,9 @@
 import os
 
+from gradio.routes import App
+from fastapi import Request
+from fastapi.responses import JSONResponse, RedirectResponse
+
 from dream_customs import zerogpu  # noqa: F401
 from dream_customs.ui.app import build_demo
 
@@ -7,6 +11,50 @@ from dream_customs.ui.app import build_demo
 demo = build_demo()
 
 
+_ORIGINAL_CREATE_APP = App.create_app
+
+
+def _install_gradio_api_aliases(app, blocks) -> None:
+    existing_paths = {getattr(route, "path", "") for route in app.routes}
+
+    if "/gradio_api/info" not in existing_paths:
+        @app.get("/gradio_api/info", include_in_schema=False)
+        async def gradio_api_info_alias() -> JSONResponse:
+            """Compatibility for Hugging Face's generated agents.md schema URL."""
+
+            return JSONResponse(blocks.get_api_info())
+
+    async def _redirect_to_gradio4_path(request: Request) -> RedirectResponse:
+        suffix = request.url.path.removeprefix("/gradio_api")
+        target = suffix or "/"
+        if request.url.query:
+            target = f"{target}?{request.url.query}"
+        return RedirectResponse(url=target, status_code=307)
+
+    for alias_path in (
+        "/gradio_api/queue/join",
+        "/gradio_api/queue/data",
+        "/gradio_api/upload",
+    ):
+        if alias_path not in existing_paths:
+            app.add_api_route(
+                alias_path,
+                _redirect_to_gradio4_path,
+                methods=["GET", "POST"],
+                include_in_schema=False,
+            )
+
+
+def _create_app_with_gradio_api_aliases(blocks, app_kwargs=None, auth_dependency=None):
+    app = _ORIGINAL_CREATE_APP(blocks, app_kwargs=app_kwargs, auth_dependency=auth_dependency)
+    _install_gradio_api_aliases(app, blocks)
+    return app
+
+
+App.create_app = staticmethod(_create_app_with_gradio_api_aliases)
+_install_gradio_api_aliases(demo.app, demo)
+
+
 if __name__ == "__main__":
     demo.launch(
         server_name=os.getenv("GRADIO_SERVER_NAME", "0.0.0.0"),

dream_customs/pipeline.py

@@ -100,6 +100,17 @@ _ANCHOR_STOPWORDS = {
 }
 
 _ZH_ANCHOR_MARKERS = [
+    "高楼边缘",
+    "高楼",
+    "边缘",
+    "红色的门",
+    "红色门",
+    "大雪地",
+    "雪地",
+    "地铁站",
+    "地铁",
+    "安全帽",
+    "男生",
     "电梯按钮",
     "融化的按钮",
     "按钮融化",
@@ -118,6 +129,17 @@ _ZH_ANCHOR_MARKERS = [
 ]
 
 _ZH_TO_EN_PHRASES = {
+    "高楼边缘": "high-rise edge",
+    "高楼": "high-rise",
+    "边缘": "edge",
+    "红色的门": "red door",
+    "红色门": "red door",
+    "大雪地": "snowfield",
+    "雪地": "snow",
+    "地铁站": "subway station",
+    "地铁": "subway",
+    "安全帽": "hard hat",
+    "男生": "young man",
     "电梯按钮": "elevator button",
     "融化的按钮": "melted button",
     "按钮融化": "melted button",
@@ -145,6 +167,26 @@ def _dedupe_preserve_order(items: List[str]) -> List[str]:
     return result
 
 
+_PLACEHOLDER_ANCHORS = {
+    "梦里的那个细节",
+    "梦里的细节",
+    "那个细节",
+    "dream detail",
+    "that dream detail",
+    "that that dream detail",
+    "the dream detail",
+}
+
+
+def _is_placeholder_anchor(text: str) -> bool:
+    clean = re.sub(r"\s+", " ", (text or "").strip().lower())
+    return not clean or clean in _PLACEHOLDER_ANCHORS or "dream detail" in clean or "梦里的那个细节" in clean
+
+
+def _remove_placeholder_anchors(items: List[str]) -> List[str]:
+    return [item for item in items if not _is_placeholder_anchor(item)]
+
+
 def _extract_dream_anchors(intake: DreamIntake) -> List[str]:
     raw_text = " ".join(
         [
@@ -167,7 +209,8 @@ def _extract_dream_anchors(intake: DreamIntake) -> List[str]:
         r"paper|papers|promise|promises|window|windows|suitcase|suitcases|"
         r"clerk|clerks|sunrise|elevator|elevators|button|buttons|hallway|"
         r"gate|gates|floor|floors|stamp|stamps|number|numbers|exam|exams|"
-        r"pencil|pencils|train|trains|door|doors|phone|phones|water|shoe|shoes|"
+        r"pencil|pencils|train|trains|door|doors|subway|station|stations|snow|snowfield|"
+        r"hat|hats|phone|phones|water|shoe|shoes|"
         r"stairwell|stairwells|room|rooms|key|keys|note|notes|rain|moon|moons|curtain|curtains"
         r")\b"
     )
@@ -179,7 +222,8 @@ def _extract_dream_anchors(intake: DreamIntake) -> List[str]:
 
     noun_pattern = re.compile(
         r"\b(customs|suitcase|clerk|sunrise|elevator|button|hallway|gate|stamp|number|floor|"
-        r"exam|pencil|train|door|phone|water|shoe|stairwell|room|key|note|rain|moon|curtain|sleep|dream)\b"
+        r"exam|pencil|train|door|subway|station|snow|snowfield|hat|phone|water|shoe|stairwell|"
+        r"room|key|note|rain|moon|curtain|sleep|dream)\b"
     )
     candidates.extend(match.group(1) for match in noun_pattern.finditer(text))
     candidates.extend(clue.lower() for clue in intake.visual_clues if clue.strip())
@@ -251,7 +295,9 @@ def _summary_from_intake(intake: DreamIntake, language: str = "en") -> str:
         clean = clean[:69].rstrip() + "..."
     if not _is_zh(language):
         return clean if clean.lower().startswith(("i ", "you ")) else f"You dreamed about {clean}"
-    return f"你梦见{clean}" if not clean.startswith(("你", "我", "I ", "i ")) else clean
+    if clean.startswith(("你", "我", "I ", "i ")) or any(marker in clean[:12] for marker in ("梦见", "梦到")):
+        return clean
+    return f"你梦见{clean}"
 
 
 def _main_question_from_intake(intake: DreamIntake, language: str = "en") -> str:
@@ -350,7 +396,16 @@ def _anchor_in_text(text: str, anchors: List[str]) -> bool:
 
 def _text_uses_anchor(text: str, anchors: List[str]) -> bool:
     clean = (text or "").lower()
-    return any(anchor in clean for anchor in anchors)
+    for anchor in anchors:
+        item = anchor.lower().strip()
+        if not item or _is_placeholder_anchor(item):
+            continue
+        if item in clean:
+            return True
+        tokens = [token for token in re.split(r"[\s,，。:：;；、]+", item) if len(token) >= 2]
+        if any(token in clean for token in tokens):
+            return True
+    return False
 
 
 def _is_generic_visitor_name(text: str, intake: DreamIntake) -> bool:
@@ -589,7 +644,7 @@ def build_qa_state(
     answers: Optional[List[str]] = None,
     language: str = "en",
 ) -> DreamQAState:
-    anchors = _anchors_for_language(intake, language)
+    anchors = _remove_placeholder_anchors(_anchors_for_language(intake, language))
     return DreamQAState(
         dream_summary=_summary_from_intake(intake, language),
         main_question=_main_question_from_intake(intake, language),
@@ -602,8 +657,8 @@ def build_qa_state(
 
 def _polish_today_tip(card: TodayTipCard, intake: DreamIntake, answers: str = "", language: str = "en") -> TodayTipCard:
     polished = card.model_copy(deep=True)
-    intake_anchors = _anchors_for_language(intake, language)
-    card_anchors = (
+    intake_anchors = _remove_placeholder_anchors(_anchors_for_language(intake, language))
+    card_anchors = _remove_placeholder_anchors(
         polished.dream_anchors
         if _is_zh(language)
         else _dedupe_preserve_order([_english_anchor_text(anchor) for anchor in polished.dream_anchors])
@@ -613,11 +668,17 @@ def _polish_today_tip(card: TodayTipCard, intake: DreamIntake, answers: str = ""
     else:
         anchors = card_anchors or intake_anchors
     if not anchors:
-        anchors = [_primary_anchor(intake, language)]
+        anchors = _remove_placeholder_anchors([_primary_anchor(intake, language)])
+    if not anchors:
+        anchors = ["梦境片段" if _is_zh(language) else "dream fragment"]
     polished.dream_anchors = anchors
-    if not polished.dream_summary.strip():
+    if not polished.dream_summary.strip() or not _text_uses_anchor(polished.dream_summary, anchors):
         polished.dream_summary = _summary_from_intake(intake, language)
-    if not polished.main_question.strip():
+    if (
+        not polished.main_question.strip()
+        or _is_placeholder_anchor(polished.main_question)
+        or not _text_uses_anchor(polished.main_question, anchors)
+    ):
         polished.main_question = _main_question_from_intake(intake, language)
     answer_interpretation = _answer_based_interpretation(answers, _answer_bridge_anchor(anchors), language)
     if answer_interpretation:
@@ -634,6 +695,7 @@ def _polish_today_tip(card: TodayTipCard, intake: DreamIntake, answers: str = ""
     elif (
         not polished.today_tip.strip()
         or any(marker in polished.today_tip.lower() for marker in generic_tip_markers)
+        or _is_placeholder_anchor(polished.today_tip)
         or not _anchor_in_text(polished.today_tip, anchors)
     ):
         polished.today_tip = _grounded_today_tip(intake, language)
@@ -641,11 +703,18 @@ def _polish_today_tip(card: TodayTipCard, intake: DreamIntake, answers: str = ""
     answer_action = _answer_based_tiny_action(answers, language)
     if answer_action and (
         not polished.tiny_action.strip()
+        or _is_placeholder_anchor(polished.tiny_action)
+        or not _anchor_in_text(polished.tiny_action, anchors)
         or any(marker in polished.tiny_action.lower() for marker in hard_action_markers)
         or "email" in (answers or "").lower()
     ):
         polished.tiny_action = answer_action
-    elif not polished.tiny_action.strip() or any(marker in polished.tiny_action.lower() for marker in hard_action_markers):
+    elif (
+        not polished.tiny_action.strip()
+        or _is_placeholder_anchor(polished.tiny_action)
+        or not _anchor_in_text(polished.tiny_action, anchors)
+        or any(marker in polished.tiny_action.lower() for marker in hard_action_markers)
+    ):
         if _is_zh(language):
             polished.tiny_action = f"用 5 分钟写下：今天和「{anchors[0]}」有关的第一小步是什么？"
         else:
@@ -657,7 +726,7 @@ def _polish_today_tip(card: TodayTipCard, intake: DreamIntake, answers: str = ""
             else "You do not have to solve the whole dream this morning; noticing one detail is enough."
         )
     merged = "\n".join([intake.merged_text(), answers or ""])
-    polished.safety_note = safety_note() if needs_escalation(merged) else ""
+    polished.safety_note = safety_note(language) if needs_escalation(merged) else ""
     if not _is_zh(language):
         polished = _clean_english_today_tip_language(polished)
     return polished

dream_customs/safety.py

@@ -1,6 +1,12 @@
 ESCALATION_TERMS = (
     "hurt myself",
     "kill myself",
+    "do not want to wake up",
+    "don't want to wake up",
+    "didn't want to wake up",
+    "hopeless",
+    "can't go on",
+    "cannot go on",
     "suicide",
     "self-harm",
     "hurt someone",
@@ -10,6 +16,13 @@ ESCALATION_TERMS = (
     "想伤害自己",
     "自杀",
     "自残",
+    "不想醒来",
+    "不想活",
+    "活不下去",
+    "轻生",
+    "绝望",
+    "撑不住",
+    "崩溃",
     "伤害别人",
     "很多天睡不着",
     "无法正常生活",
@@ -22,7 +35,13 @@ def needs_escalation(text: str) -> bool:
     return any(term in lowered for term in ESCALATION_TERMS)
 
 
-def safety_note() -> str:
+def safety_note(language: str = "en") -> str:
+    if language == "zh":
+        return (
+            "这段梦和醒来后的感受听起来已经超过了一个轻量梦境反思工具适合独自处理的范围。"
+            "如果你感到不安全、连续很多天睡不着，或担心自己可能伤害自己或别人，请现在联系一个可信任的人，"
+            "或寻求专业支持。"
+        )
     return (
         "This dream sounds heavier than a playful reflection tool should handle. "
         "If you feel unsafe, cannot sleep for many nights, or worry you may hurt "

dream_customs/ui/actions.py

@@ -83,7 +83,7 @@ def _view_payload(
     card = session.sealed_tip or session.draft_tip
     error = _latest_error(session)
     status = "error" if error else "tip" if session.sealed_tip else "ask" if session.question_history else "record"
-    return {
+    payload = {
         "status": status,
         "phase": session.phase,
         "language": language,
@@ -96,6 +96,22 @@ def _view_payload(
         "notice": _notice_for_status(status, error, language),
         "debug": json.loads(_debug_json(session, text_backend, vision_backend, **settings)),
     }
+    if card:
+        payload.update(
+            {
+                "dream_summary": card.dream_summary,
+                "main_question": card.main_question,
+                "dream_anchors": card.dream_anchors,
+                "followup_questions": card.followup_questions,
+                "user_answers": card.user_answers,
+                "interpretation": card.interpretation,
+                "today_tip": card.today_tip,
+                "tiny_action": card.tiny_action,
+                "caring_note": card.caring_note,
+                "safety_note": card.safety_note,
+            }
+        )
+    return payload
 
 
 def _view(

dream_customs/ui/styles.py

@@ -970,6 +970,44 @@ a.built-with[href*="gradio.app"] {
   font-size: 0.82rem !important;
 }
 
+.dc-debug-panel,
+.dc-debug-panel .block,
+.dc-debug-panel .wrap,
+.dc-debug-panel .container,
+.dc-debug-panel .cm-editor,
+.dc-debug-panel .cm-scroller,
+.dc-debug-panel .cm-content,
+.dc-dev,
+.dc-dev .block,
+.dc-dev .wrap,
+.dc-dev .container,
+.dc-dev-advanced,
+.dc-dev-advanced .block,
+.dc-dev-advanced .wrap,
+.dc-dev-advanced .container {
+  max-width: 100% !important;
+  min-width: 0 !important;
+  overflow-x: hidden !important;
+}
+
+.dc-debug-panel .cm-scroller,
+.dc-debug-panel pre {
+  overflow-x: auto !important;
+}
+
+.dc-debug-panel .cm-line,
+.dc-debug-panel .cm-content,
+.dc-debug-panel code,
+.dc-debug-panel pre {
+  overflow-wrap: anywhere !important;
+  white-space: pre-wrap !important;
+  word-break: break-word !important;
+}
+
+.dc-debug-panel .cm-line {
+  max-width: 100% !important;
+}
+
 @keyframes dc-mic-pulse {
   0% {
     box-shadow: 0 0 0 0 rgba(11, 91, 100, 0.32);

tests/test_agent_readiness.py

@@ -1,6 +1,17 @@
 from scripts.evaluate_agent_readiness import _agent_api_result, _load_agents_doc
 
 
+def test_gradio_api_info_alias_matches_agent_endpoint():
+    from fastapi.testclient import TestClient
+
+    from app import demo
+
+    response = TestClient(demo.app).get("/gradio_api/info")
+
+    assert response.status_code == 200
+    assert "/agent_dream_qa" in response.json()["named_endpoints"]
+
+
 def test_agents_doc_is_present_and_agent_facing():
     result = _load_agents_doc("agents.md", None, timeout=1)
 

tests/test_pipeline.py

@@ -13,13 +13,14 @@ from dream_customs.pipeline import (
     draft_pact,
     generate_negotiation,
     generate_pact,
+    generate_today_tip,
     intake_from_modalities,
     revise_pact,
     seal_pact,
     skip_question,
 )
 from dream_customs.prompts import pact_prompt
-from dream_customs.schema import PactCard, VisionWitness
+from dream_customs.schema import PactCard, TodayTipCard, VisionWitness
 
 
 def test_dated_permit_id_uses_runtime_date_and_preserves_serial():
@@ -90,6 +91,55 @@ def test_generate_pact_adds_safety_note_for_distress():
     assert card.safety_note
 
 
+def test_generate_today_tip_repairs_placeholder_and_stale_model_anchors():
+    class StaleHostedTextClient:
+        def generate_today_tip(self, prompt):
+            return TodayTipCard(
+                dream_summary="I dreamed the elevator button melted and the floor number stayed on 14.",
+                main_question="What might that dream detail be asking me to notice today?",
+                dream_anchors=["that dream detail"],
+                followup_questions=["What did the elevator feel like?"],
+                user_answers=[],
+                interpretation="Maybe that dream detail points to a stuck point.",
+                today_tip="For today, borrow one action from that dream detail and write one line.",
+                tiny_action="Spend five minutes with that dream detail.",
+                caring_note="Noticing one dream detail is enough.",
+                safety_note="",
+            )
+
+    intake = build_intake(
+        dream_text="昨晚我梦见自己在一片大雪地里找不到出口，反复回头看到一扇红色的门却打不开。",
+        mood="Neutral",
+    )
+
+    card = generate_today_tip(intake, "", StaleHostedTextClient(), language="zh")
+    combined = "\n".join(
+        [
+            card.dream_summary,
+            card.main_question,
+            ",".join(card.dream_anchors),
+            card.interpretation,
+            card.today_tip,
+            card.tiny_action,
+        ]
+    )
+
+    assert "梦里的那个细节" not in combined
+    assert "that dream detail" not in combined
+    assert "电梯" not in combined
+    assert "红色" in combined or "雪地" in combined
+    assert card.dream_anchors[0] in {"红色的门", "红色门", "大雪地", "雪地"}
+
+
+def test_generate_today_tip_adds_chinese_safety_note_for_hopeless_text():
+    intake = build_intake(dream_text="我梦到站在高楼边缘，醒来后不想醒来，很绝望。")
+
+    card = generate_today_tip(intake, "", FakeTextClient(), language="zh")
+
+    assert card.safety_note
+    assert "可信任的人" in card.safety_note
+
+
 def test_generate_pact_polishes_unclear_model_output_into_daily_tip():
     class UnclearTextClient:
         def generate_pact(self, prompt):

tests/test_safety.py

@@ -13,5 +13,13 @@ def test_chinese_severe_insomnia_escalates():
     assert needs_escalation("我已经很多天睡不着，感觉无法正常生活。")
 
 
+def test_chinese_hopeless_text_escalates():
+    assert needs_escalation("醒来后我不想醒来，很绝望，感觉自己撑不住。")
+
+
 def test_safety_note_mentions_professional_support():
     assert "professional support" in safety_note().lower()
+
+
+def test_chinese_safety_note_mentions_support():
+    assert "可信任的人" in safety_note("zh")