"""
Exercise generators for text, dialogue, visual, and pronunciation features.
All feedback uses encouraging language — see prompts.py for tone constraints.
"""
import json
import base64
import io
import logging
import os
from db import get_cursor
import gamify
import llm
import prompts
logger = logging.getLogger(__name__)
# ── Text exercise (Day 6) — kept for app.py's themed-Blocks fallback ──────────
def generate_text_exercise(lesson_text: str, user_id: str) -> dict:
result = llm.chat_json(
prompts.TEXT_EXERCISE_SYSTEM,
f"Lesson text:\n{lesson_text[:800]}",
fallback=_FALLBACK_EXERCISES["fill_blank"],
)
_save_exercise(user_id, None, "text", result.get("sentence_with_blank"), result.get("answer"), result)
return result
def render_text_exercise(ex: dict) -> str:
if not ex:
return ""
return (
f''
f'
{ex.get("instruction","")}
'
f'
'
f'{ex.get("sentence_with_blank","")}
'
f'
Hint: {ex.get("hint","")}
'
f'
'
f'
{icon} {label}
'
f'
{explanation}
'
f'
📍 {scene}
'
]
for turn in turns:
if turn["speaker"] == "agent":
parts.append(
f''
f'{agent_role}
'
f'{turn["text"]}'
f''
f'({turn.get("translation","")})'
f'
'
)
else: # user turn — _visible_turns guarantees a reply exists
reply = completed_replies[reply_idx]
parts.append(
f''
f'{user_role}
'
f'{reply}'
f'
'
)
reply_idx += 1
return f'{"".join(parts)}
'
def get_next_user_hint(dialogue: dict, replies_count: int) -> str:
"""Return the hint for the next user turn."""
user_turns = [t for t in dialogue.get("turns", []) if t["speaker"] == "user"]
if replies_count < len(user_turns):
return user_turns[replies_count].get("hint", "Respond naturally")
return ""
def dialogue_feedback(user_reply: str, hint: str, scene: str, user_id: str) -> dict:
result = llm.chat_json(
prompts.DIALOGUE_FEEDBACK_SYSTEM,
prompts.dialogue_feedback_user(user_reply, hint, scene),
fallback={
"feedback": "Bien joué ! (Well done!) Replying in French takes courage — keep it up, you're making great progress.",
"natural_version": "",
},
)
_save_points_for_dialogue(user_id)
return result
def _save_points_for_dialogue(user_id: str):
try:
from gamify import add_points
add_points(user_id, "dialogue_turn")
except Exception:
pass
# ── Visual exercise (Day 8) ───────────────────────────────────────────────────
def generate_visual_exercise(pil_image, user_id: str) -> dict:
"""Upload image → vision LLM describes → text LLM builds exercises."""
import io, base64
buf = io.BytesIO()
pil_image.save(buf, format="JPEG", quality=85)
image_b64 = base64.b64encode(buf.getvalue()).decode()
description = llm.vision_chat(image_b64, prompts.VISUAL_DESCRIBE_PROMPT)
if description.startswith("⚠"):
return {"error": description, "exercises": []}
result = llm.chat_json(
prompts.VISUAL_EXERCISE_SYSTEM,
f"Image content:\n{description}",
fallback={"image_summary": description, "exercises": []},
)
_save_exercise(user_id, None, "visual", None, None, result)
return result
def render_visual_exercises(result: dict) -> str:
if "error" in result:
return f'{result["error"]}
'
exercises = result.get("exercises", [])
summary = result.get("image_summary", "")
if not exercises:
return 'No exercises generated.
'
parts = [f'📷 {summary}
']
for i, ex in enumerate(exercises, 1):
hint = ex.get("hint", "")
hint_html = f'Hint: {hint}
' if hint else ""
parts.append(
f''
f'
Exercise {i} — {ex.get("type","").title()}
'
f'
{ex.get("instruction","")}
'
f'
{ex.get("content","")}
'
f'{hint_html}'
f'
'
f'Show answer
'
f'{ex.get("answer","")} — {ex.get("explanation","")}
'
f'