TinyWorld + Crisis Mode, ZeroGPU in-process inference

README.md

@@ -1,13 +1,94 @@
 ---
-title: Tinyworld
-emoji: 🌍
-colorFrom: purple
-colorTo: pink
+title: TinyWorld
+emoji: 🏘️
+colorFrom: blue
+colorTo: purple
 sdk: gradio
-sdk_version: 6.18.0
-python_version: '3.13'
+sdk_version: "6.18.0"
 app_file: app.py
 pinned: false
+tags:
+  - hackathon
+  - build-small
+  - adventure-in-thousand-token-wood
+  - openbmb/MiniCPM5-1B
+  - nvidia/Nemotron-Mini-4B-Instruct
+  - openbmb/VoxCPM2
+  - cohere/cohere-transcribe-03-2026
 ---
 
-Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference
+# 🏘️ TinyWorld
+
+**Throw an event. Watch the neighborhood react.**
+
+A tiny life-sim town where AI characters react unpredictably, follow routines, and obey directed commands in their own voices. Built for the **Build Small Hackathon 2026** (Hugging Face × Gradio), targeting the **Adventure in Thousand Token Wood** track.
+
+## Source
+
+Public GitHub repo: [Sushruths04/tinyworld-reactive-neighborhood](https://github.com/Sushruths04/tinyworld-reactive-neighborhood)
+
+Built with OpenAI Codex. See the commit history for Codex-attributed commits.
+
+## How to Play
+
+1. **Type an event** in the textbox (or click 🎲 Random Chaos for inspiration).
+2. **Hit ⚡ Trigger** — watch the addressed character or whole town react on the canvas.
+3. **Listen** — the most dramatic reaction auto-speaks via VoxCPM2 voice. Pick another character from the dropdown and hit 🔊 to hear them too.
+
+## 🎬 Crisis Mode — "The Long Summer"
+
+Beyond the open sandbox, TinyWorld has a story-driven **co-op survival** mode inspired by *Among Us*: **you are the saboteur**. Switch to **🎬 Campaign** and press **Start Campaign** to inject a linked season of escalating crises — a café fire, a heatwave blackout, a storm, a missing child, and a finale. The five residents must perceive, coordinate, and **actually resolve** each crisis before the **chaos meter** maxes out.
+
+- **Deterministic resolution** — each crisis declares *requirements* (e.g. fire → contain it at the café, get the medic on scene, evacuate). The engine checks each resident's chosen destination and action against those requirements; the LLM only *speaks*, the engine decides whether it's solved (`crisis.py`).
+- **Multi-round coordination** — unmet requirements feed back into the next round ("the fire is still spreading, no medic on scene"), so the town has to organize across rounds. You can also type directed commands ("Jay, put the fire out at the café") to rally a specific resident.
+- **Story & stakes** — clear all five chapters to trigger the **finale reveal**: every disaster traced back to one source — *you*. Each chapter is graded, names an **MVP resident**, and surfaces a teaching question about *how five different minds approach the same emergency differently* (`campaign.py`).
+
+Play it locally end-to-end with no network:
+
+```bash
+TINYWORLD_MOCK=1 python3 acceptance_check.py   # offline win + collapse playthrough
+TINYWORLD_MOCK=1 python3 -m pytest -q          # full test suite incl. crisis/campaign
+```
+
+### Architecture note (portability)
+
+The game engine is host-agnostic: `crisis.py`, `campaign.py`, `agents.py`, `decide.py`, `router.py`, `world_state.py`, and `worlds/` never import `gradio` (enforced by `tests/test_portability.py`). `app.py` is a thin Gradio adapter. This boundary is the seam that lets the same engine be wrapped by a Streamlit or FastAPI front-end later without touching the core.
+
+## What Makes It Unpredictable
+
+Every reaction is shaped by 4 hidden layers:
+- **Mood** — each character has a secret mood that re-rolls after every event.
+- **Memory** — they remember their last 3 reactions and reference them.
+- **Relationships** — friendships, rivalries, and crushes color how they respond.
+- **Surprise Seeds** — a random creative instruction appended to every prompt.
+
+Trigger the same event 3 times → you get 3 completely different reactions each time.
+
+## Models Used (all ≤ 4B params)
+
+| Model | Params | Role | Sponsor |
+|---|---|---|---|
+| `nvidia/Nemotron-Mini-4B-Instruct` | 4B | Primary character dialogue model for all worlds | NVIDIA |
+| `openbmb/MiniCPM5-1B` | 1B | Lightweight fallback dialogue model on Modal | OpenBMB |
+| `openbmb/VoxCPM2` | 2B | Character voice synthesis (TTS) | OpenBMB |
+| Whisper `base` on Modal | ~74M | Primary speech-to-text (mic input) | Modal |
+| `Cohere Transcribe` | 2B | Speech-to-text fallback path | Cohere |
+
+**Total model budget: under 10B params** (well under the 32B cap — earns the *Tiny Titan* badge).
+
+## Built With
+
+- [Gradio](https://gradio.app) — web UI framework
+- [Hugging Face Spaces](https://huggingface.co/spaces) — deployment
+- [ZeroGPU](https://huggingface.co/docs/transformers/optimization/bnbs#zero-gpu) — GPU access on Spaces
+
+## Sponsor Credits
+
+- **NVIDIA** — Nemotron-Mini-4B-Instruct (character dialogue)
+- **OpenBMB** — MiniCPM5-1B fallback + VoxCPM2 voice synthesis
+- **Modal** — serverless LLM, voice, and Whisper transcription endpoints
+- **Cohere** — Transcribe fallback path
+
+---
+
+*Built for Build Small Hackathon 2026 · Hugging Face × Gradio · Thousand Token Wood track*

agents.py

@@ -0,0 +1,912 @@
+import os
+import random
+import re
+import time
+import concurrent.futures
+import decide
+import world_state
+from worlds import get_world
+
+MOCK = os.environ.get("TINYWORLD_MOCK", "0") == "1"
+
+MODAL_REACT_URL = os.environ.get(
+    "MODAL_REACT_URL",
+    "https://mitvho09--tinyworld-inference-react-endpoint.modal.run",
+)
+
+PRIMARY_MODEL = "nvidia/Nemotron-Mini-4B-Instruct"
+_FAILURES = 0
+_CIRCUIT_OPEN_UNTIL = 0.0
+_RUNTIME_STATUS = {
+    "mode": "mock" if MOCK else "unknown",
+    "model": "offline demo" if MOCK else PRIMARY_MODEL,
+    "message": "Offline demo (mock)" if MOCK else "Model not checked yet",
+    "latency": None,
+    "error": None,
+}
+
+MOODS = [
+    "happy", "stressed", "bored", "excited", "hungry",
+    "tired", "nostalgic", "curious", "proud", "embarrassed",
+]
+
+SURPRISE_SEEDS = [
+    "Slip in one oddly specific detail from earlier today.",
+    "React as if this event confirms a private theory you never told anyone.",
+    "Let a petty personal concern steer part of your response.",
+    "Compare the event to a memory that still annoys you.",
+    "Say one thing confidently, then soften or complicate it.",
+    "Ask one pointed question that reveals your bias.",
+    "Treat one small part of the event as the real emergency.",
+    "Reveal a secret wish connected to the situation.",
+    "Interpret the event through your relationship with someone nearby.",
+    "End with a surprising offer, warning, or demand.",
+]
+
+MOOD_CONTEXT = {
+    "happy": "You are in a good mood. Let that warmth show.",
+    "stressed": "You are stressed and overwhelmed. It colors your view.",
+    "bored": "You are bored. Nothing impresses you.",
+    "excited": "You are buzzing with excitement.",
+    "hungry": "You are hungry and losing patience.",
+    "tired": "You are exhausted. Everything is too much effort.",
+    "nostalgic": "You are nostalgic. The past feels more real.",
+    "curious": "You are intensely curious. You want answers.",
+    "proud": "You are proud. This is your turf.",
+    "embarrassed": "You are embarrassed. You hope nobody noticed.",
+}
+
+GENERIC_MOCK = {
+    "happy": ["Honestly? I love this. Best thing to happen here in ages.", "Oh, this is wonderful. Count me in!"],
+    "stressed": ["This is exactly what I was afraid of. We need a plan, now.", "Okay, okay — everybody stay calm. Mostly me."],
+    "bored": ["Huh. Neat, I guess. Wake me if it gets interesting.", "Seen weirder. Slightly."],
+    "excited": ["No way! This is HUGE, we have to do something!", "I have been WAITING for something like this!"],
+    "hungry": ["Can we deal with this after I eat? Just asking.", "Great, drama on an empty stomach."],
+    "tired": ["I do not have the energy for this today.", "Can someone else handle it? I'm wiped."],
+    "nostalgic": ["This takes me back. Funny how things come around.", "Reminds me of the old days, before all... this."],
+    "curious": ["Wait, how does that even work? I need to know more.", "Fascinating. Let me get a closer look."],
+    "proud": ["Stand back — I've got this handled.", "Finally, a chance to show what I can do."],
+    "embarrassed": ["Oh no. Please tell me nobody saw that.", "I'm just going to pretend that didn't happen."],
+}
+
+MOCK_REACTIONS = {
+    "Marta Voss": {
+        "happy": [
+            "Well, that's a pleasant surprise. I could use more days like this around here.",
+            "Ha! Finally something good happens. Don't tell anyone I said that.",
+        ],
+        "stressed": [
+            "Oh great, just what I needed. As if this block wasn't chaotic enough already.",
+            "I'm going to need a moment. Or a time machine to 1987.",
+        ],
+        "bored": [
+            "Huh. That's something, I guess. Wake me when it gets interesting.",
+            "Back in my day, we had real excitement. This is... fine.",
+        ],
+        "excited": [
+            "Now THIS is what I've been waiting for! Reminds me of the great power outage of '09!",
+            "I've been watching this neighborhood for forty years and THIS is the day!",
+        ],
+        "hungry": [
+            "Nice, but can we talk about lunch first? I skipped my tea.",
+            "That's all well and good, but I haven't had a decent scone since Tuesday.",
+        ],
+        "tired": [
+            "Can this wait? I barely slept last night thanks to Jay's delivery bike.",
+            "*yawn* That's... very... I need my afternoon nap.",
+        ],
+        "nostalgic": [
+            "This reminds me of something from '83. Similar energy, different decade.",
+            "You know, we had something like this once before. Not quite the same though.",
+        ],
+        "curious": [
+            "Wait, hold on. Tell me more. What exactly did you see?",
+            "Something doesn't add up. I've been watching this street for decades and I notice things.",
+        ],
+        "proud": [
+            "I've been saying this block would get noticed. Called it years ago.",
+            "This is exactly the kind of thing I've seen coming. You're all welcome.",
+        ],
+        "embarrassed": [
+            "Oh no. Please tell me nobody saw me react to that.",
+            "I... uh... let's just pretend that didn't happen.",
+        ],
+    },
+    "Jay Park": {
+        "happy": [
+            "Ha! Finally! I KNEW something good was coming today! My luck's turning around!",
+            "This is amazing! I'm already texting everyone about it!",
+        ],
+        "stressed": [
+            "Oh no. Oh no no no. I literally cannot deal with this right now!",
+            "My schedule is already packed and NOW this happens?!",
+        ],
+        "bored": [
+            "That's... cool I guess? I've seen more exciting delivery routes.",
+            "Wake me when something actually interesting happens. I'm going for a ride.",
+        ],
+        "excited": [
+            "WAIT WAIT WAIT — did you SEE that?! This is HUGE! I'm already on it!",
+            "I KNEW something like this would happen! My instincts are NEVER wrong!",
+        ],
+        "hungry": [
+            "Cool cool cool, but has anyone seen the pizza truck? I'm STARVING.",
+            "I'd be more excited if I hadn't skipped lunch for three deliveries.",
+        ],
+        "tired": [
+            "Mmhmm. Very cool. *stares into distance* I delivered twelve orders today.",
+            "Can this wait? My legs are literally trembling.",
+        ],
+        "nostalgic": [
+            "This gives me the same vibe as that time I found twenty bucks in a taxi. Good memories.",
+            "You know, this reminds me of my first week on the job. Good times.",
+        ],
+        "curious": [
+            "Wait, what?! Tell me EVERYTHING. I need details!",
+            "Something's up. I ride through here every day and I notice things.",
+        ],
+        "proud": [
+            "Ha! I've been saying this neighborhood was special! Who's laughing now?",
+            "I literally called this. Check my texts from last week.",
+        ],
+        "embarrassed": [
+            "Oh god. Please tell me I didn't just yell that out loud.",
+            "I'm going to ride away now. Very fast. In the opposite direction.",
+        ],
+    },
+    "Nia Okafor": {
+        "happy": [
+            "Well, that's a nice change of pace. I could get used to this.",
+            "Good. We deserve something good around here for once.",
+        ],
+        "stressed": [
+            "Okay, deep breaths. I've handled worse in the ambulance. This is fine.",
+            "Of course this happens on my day off. Of course it does.",
+        ],
+        "bored": [
+            "Fascinating. Truly. *checks watch* I've seen more action at a stop sign.",
+            "My enthusiasm is immeasurable. *yawn*",
+        ],
+        "excited": [
+            "Now THIS is interesting! Finally, something that gets the blood pumping!",
+            "Oh, this is good. This is REALLY good. I'm alert now.",
+        ],
+        "hungry": [
+            "I've got one eye on this and one eye on the clock. Shift starts in an hour and I need food.",
+            "Cool, but I'm about to pass out from low blood sugar. Priorities.",
+        ],
+        "tired": [
+            "I've seen worse. Much worse. But I'd rather be sleeping right now.",
+            "Can we... handle this efficiently? I worked a double shift.",
+        ],
+        "nostalgic": [
+            "This reminds me of my first month on the job. Similar chaos, different faces.",
+            "You know, we had something like this at the hospital once. Long story.",
+        ],
+        "curious": [
+            "Hold on. What exactly happened? I need the facts before I react.",
+            "Something's not right here. I read situations for a living and this is off.",
+        ],
+        "proud": [
+            "This neighborhood doesn't get enough credit. But I've always known.",
+            "I've been protecting this block for years. Nice to see others noticing.",
+        ],
+        "embarrassed": [
+            "I... that was unprofessional. Let's move on.",
+            "Nobody saw that. Nobody. *straightens uniform*",
+        ],
+    },
+    "Luca Bell": {
+        "happy": [
+            "OH MY GOSH THIS IS THE BEST DAY EVER! I need to document everything!",
+            "I KNEW something amazing would happen! My notebook predicted this!",
+        ],
+        "stressed": [
+            "This is TERRIBLE! This is the worst thing that has EVER happened on this block!",
+            "I'm writing this down as a DISASTER. My notebook needs a new chapter!",
+        ],
+        "bored": [
+            "That's it? I expected more. My notebook is disappointed.",
+            "I've been waiting for something cool and THIS is what we get?",
+        ],
+        "excited": [
+            "THIS IS THE MOST IMPORTANT THING THAT HAS EVER HAPPENED! I'M SHAKING!",
+            "I need to record this IMMEDIATELY! Future historians will thank me!",
+        ],
+        "hungry": [
+            "I'd be more excited but I skipped lunch to wait for something cool to happen.",
+            "This is amazing but I'm literally starving. Can we celebrate with snacks?",
+        ],
+        "tired": [
+            "I want to care about this but my eyes won't stay open.",
+            "Can... can this wait? I was up until 2am researching neighborhood legends.",
+        ],
+        "nostalgic": [
+            "This reminds me of the time I found that old map in Marta's shop! Similar vibes!",
+            "You know, this is exactly the kind of thing I've been writing about for months!",
+        ],
+        "curious": [
+            "Wait WHAT?! I need to investigate this IMMEDIATELY! Where's my notebook?!",
+            "This is suspicious. Very suspicious. I'm going to get to the bottom of this!",
+        ],
+        "proud": [
+            "I TOLD everyone something amazing would happen here! Check my notebook!",
+            "This is proof! This neighborhood is SPECIAL and I've been saying it all along!",
+        ],
+        "embarrassed": [
+            "I just screamed really loud didn't I? Please tell me nobody heard that.",
+            "I'm going to go hide in my room now. For several days.",
+        ],
+    },
+    "Priya Raman": {
+        "happy": [
+            "Well, this is a welcome surprise. I'll add it to the positive column.",
+            "Good. This block could use some good news for a change.",
+        ],
+        "stressed": [
+            "First, let's assess the situation. Second, let's make a plan. Third, PANIC.",
+            "I'm making a list. Of everything that could go wrong. It's a long list.",
+        ],
+        "bored": [
+            "I'll believe it when I see it. Until then, I have zoning reports to review.",
+            "Everyone calm down. This probably isn't what it seems.",
+        ],
+        "excited": [
+            "Okay, I'll admit it — this is genuinely exciting. I'm making an exception to my skepticism.",
+            "This changes the whole dynamic of the block! I need to recalculate everything!",
+        ],
+        "hungry": [
+            "I hate to admit it, but I'm too hungry to think clearly right now.",
+            "Can we table this discussion until after lunch? I'm not functioning.",
+        ],
+        "tired": [
+            "I've got my eye on this, but I'm too exhausted to process it fully.",
+            "This is significant, but I need coffee before I can formulate a proper response.",
+        ],
+        "nostalgic": [
+            "There's something beautiful about chaos, isn't there? Even organized chaos.",
+            "I hate to admit it, but this is kind of poetic. In a messy sort of way.",
+        ],
+        "curious": [
+            "Something doesn't add up here. I'm going to look into this officially.",
+            "I need more data before I form an opinion. This feels... incomplete.",
+        ],
+        "proud": [
+            "I've spent years trying to improve this block. Nice to see it getting attention.",
+            "This is exactly the kind of thing I've been working toward. You're welcome.",
+        ],
+        "embarrassed": [
+            "I just got excited about something unprofessional didn't I? Let's never speak of this.",
+            "My carefully maintained composure just cracked. Wonderful.",
+        ],
+    },
+}
+
+MOVEMENT_HINTS = [
+    "If you'd naturally move somewhere during this event, end your reaction with [GOTO: hotspot_name].",
+    "If this event would make you walk to a different part of the neighborhood, end with [GOTO: hotspot_name].",
+    "Stay put unless the event strongly draws you somewhere else. If you move, end with [GOTO: hotspot_name].",
+]
+
+HOTSPOT_KEYS = [
+    "marta_home", "cafe", "park", "square", "jay_home",
+    "school", "nia_clinic", "priya_office",
+]
+
+
+def _build_mood_context(mood):
+    return MOOD_CONTEXT.get(mood, "")
+
+
+def _hotspots(world):
+    """Destinations a character can choose. Prefer board tiles (what the app maps
+    and the renderer draws); fall back to the legacy top-level dict. Robust for
+    every world — starhaven/old_town only define board['hotspots_tile']."""
+    return (world.get("board", {}) or {}).get("hotspots_tile") or world.get("hotspots") or {}
+
+
+def build_agent_prompt(character, event, mood, memory, relationships, world):
+    seed = random.choice(SURPRISE_SEEDS)
+    movement = random.choice(MOVEMENT_HINTS)
+
+    memory_str = ""
+    if memory:
+        memory_str = "Your recent memories: " + "; ".join(memory[-4:]) + "."
+
+    reflection = world_state.get_reflection(world["id"], character["name"])
+    reflection_str = ""
+    if reflection:
+        reflection_str = f"Inner reflection: {reflection}"
+
+    hotspots = ", ".join(_hotspots(world).keys())
+
+    persona = (
+        f"You are {character['name']}, a {character['age']}-year-old {character['job']}. "
+        f"Traits: {', '.join(character['traits'])}. "
+        f"Backstory: {character['backstory']}. "
+        f"Catchphrase style: {character.get('catchphrase_hint', '')}. "
+        f"{relationships} "
+        f"{memory_str} "
+        f"{reflection_str}"
+    )
+
+    first = character["name"].split()[0]
+    prompt = (
+        f"{persona}\n\n"
+        f"Your mood right now: {mood}. {_build_mood_context(mood)}\n\n"
+        f"Something just happened on your street: \"{event}\"\n\n"
+        f"React the way {first} truly would. In 1 to 2 short sentences, speak OUT LOUD in first person "
+        f"— your own voice — showing you understood what happened and what you mean to do about it. "
+        f"{seed} "
+        f"Speak ONLY as {first}: no narration, no stage directions, no notes to yourself, no labels, no quotation marks."
+    )
+    return prompt
+
+
+# scratch / meta lines a weak model leaks instead of staying in character
+_META_RE = re.compile(
+    r"^(let me\b|i need to\b|i should\b|i'll (incorporate|write|make|ensure)|now,?\s*i\b|"
+    r"but the format\b|i think that works\b|first,?\s*i\b|okay,?\s*(so|let)\b|here('s| is)\b|"
+    r"in the (do|think|say)\b|for (the )?(say|do|think)\b|the format\b|as an ai\b|sure,?\s|note:)",
+    re.IGNORECASE,
+)
+
+# task-referential phrases that mean the model is talking about the assignment, not the street
+_META_CONTAINS = re.compile(
+    r"(sentence|i'?ll count|let'?s (write|count|ensure)|1 to 2|the format|in character|"
+    r"the prompt|stage direction|first sentence|i (will|'?ll) (say|write))",
+    re.IGNORECASE,
+)
+
+
+def _clean_line(raw):
+    """Pull a clean, in-character spoken line out of a messy small-model reply."""
+    raw = (raw or "").strip()
+    m = re.search(r"say\s*:\s*(.+)", raw, re.IGNORECASE)      # honor old SAY: format if used
+    cand = m.group(1).strip() if m else raw
+    cand = re.sub(r"\b(think|do|say|goto)\s*:\s*", " ", cand, flags=re.IGNORECASE)
+    cand = re.sub(r"\[[^\]]*\]", "", cand)                    # [GOTO: ...] / brackets
+    cand = re.sub(r"\*[^*]*\*", "", cand)                     # *stage directions*
+    cand = cand.replace("\n", " ").strip()
+    parts = re.split(r"(?<=[.!?])\s+", cand)
+    keep = [p.strip(" \"'") for p in parts
+            if p.strip() and not _META_RE.match(p.strip()) and not _META_CONTAINS.search(p)]
+    # empty => nothing in-character survived; caller falls back to a persona line
+    return " ".join(keep[:2]).strip(" \"'")
+
+
+def _parse_goto(text):
+    match = re.search(r'\[GOTO:\s*(\w+)\]', text)
+    if match:
+        hotspot = match.group(1)
+        clean_text = re.sub(r'\[GOTO:\s*\w+\]', '', text).strip()
+        if hotspot in HOTSPOT_KEYS:
+            return clean_text, hotspot
+        return clean_text, None
+    return text, None
+
+
+def _field(text, key):
+    m = re.search(rf'^\s*{key}\s*:\s*(.+?)\s*$', text, re.IGNORECASE | re.MULTILINE)
+    return m.group(1).strip() if m else ""
+
+
+def _parse_structured(raw, world):
+    """Pull THINK / DO / SAY / GOTO out of a reasoning reply. Falls back to the
+    older [GOTO] / free-text shape so a model that ignores the format still works."""
+    think = _field(raw, "THINK")
+    do = _field(raw, "DO")
+    say = _field(raw, "SAY")
+    goto_raw = _field(raw, "GOTO")
+
+    goto = None
+    keys = list(_hotspots(world).keys())
+    if goto_raw:
+        cand = re.sub(r'[^a-z_]', '', goto_raw.lower().replace(" ", "_"))
+        if cand in keys:
+            goto = cand
+        else:
+            for k in keys:
+                if k in cand or cand in k:
+                    goto = k
+                    break
+
+    if not say:
+        # model didn't follow the format — treat the whole thing as the spoken line
+        say, legacy_goto = _parse_goto(raw.strip())
+        goto = goto or legacy_goto
+
+    # trim a stray DO that leaked into the spoken line
+    say = re.sub(r'^(THINK|DO|SAY|GOTO)\s*:\s*', '', say, flags=re.IGNORECASE).strip()
+    return think, do, say or raw.strip(), goto
+
+
+def _compute_drama(text):
+    drama = random.uniform(0.2, 0.9)
+    exclamations = text.count("!")
+    caps_words = sum(1 for w in text.split() if w.isupper() and len(w) > 2)
+    drama = min(1.0, drama + exclamations * 0.05 + caps_words * 0.05)
+    return round(drama, 3)
+
+
+def _compute_vibe_delta(mood):
+    base = {"energy": 0.0, "social": 0.0}
+    mood_energy = {
+        "happy": 0.08, "excited": 0.12, "proud": 0.06, "curious": 0.04,
+        "stressed": -0.1, "bored": -0.08, "tired": -0.15, "hungry": -0.05,
+        "nostalgic": 0.02, "embarrassed": -0.03,
+    }
+    mood_social = {
+        "happy": 0.1, "excited": 0.08, "curious": 0.06, "proud": 0.02,
+        "nostalgic": 0.04, "stressed": -0.06, "bored": -0.1, "tired": -0.08,
+        "hungry": -0.04, "embarrassed": -0.05,
+    }
+    base["energy"] = mood_energy.get(mood, 0.0) + random.uniform(-0.02, 0.02)
+    base["social"] = mood_social.get(mood, 0.0) + random.uniform(-0.02, 0.02)
+    return base
+
+
+def _compute_affinity_deltas(name, character, mood):
+    deltas = {}
+    for other_name, rel in character.get("relationships", {}).items():
+        if rel == "friend":
+            deltas[other_name] = random.uniform(0.01, 0.04)
+        elif rel == "rival":
+            deltas[other_name] = random.uniform(-0.04, -0.01)
+        elif rel == "crush":
+            deltas[other_name] = random.uniform(0.02, 0.06)
+        elif rel == "family":
+            deltas[other_name] = random.uniform(0.01, 0.03)
+        if mood in ("stressed", "angry"):
+            deltas[other_name] = deltas.get(other_name, 0) - 0.02
+        elif mood in ("happy", "excited"):
+            deltas[other_name] = deltas.get(other_name, 0) + 0.01
+    return deltas
+
+
+# keyword -> where a sensible person would head to deal with that kind of situation
+_EVENT_HOTSPOT = [
+    (("power", "outage", "lights", "electric"), "priya_office"),
+    (("school", "kids", "class", "student"), "school"),
+    (("hurt", "injur", "accident", "sick", "fire", "emergency", "storm"), "nia_clinic"),
+    (("food", "truck", "hungry", "coffee", "cafe", "café"), "cafe"),
+    (("park", "tree", "object", "glow", "mural", "cat", "kitten", "animal"), "park"),
+    (("meeting", "everyone", "gather", "crowd", "news", "vote"), "square"),
+]
+
+
+def _mock_brain(character, event, world):
+    """Cheap stand-in for real reasoning: a relevant destination + a concrete action,
+    so even the offline demo shows characters engaging the situation, not just emoting."""
+    e = event.lower()
+    hs = _hotspots(world)
+    goto = None
+    for keys, spot in _EVENT_HOTSPOT:
+        if any(k in e for k in keys) and spot in hs:
+            goto = spot
+            break
+    if not goto:
+        goto = "square" if "square" in hs else (random.choice(list(hs.keys())) if hs else None)
+    # spread the cast out: about half deal with it on their own turf instead of all piling onto one spot
+    home = character.get("home")
+    if home in hs and random.random() < 0.5:
+        goto = home
+    job = character.get("job", "neighbor")
+    action = random.choice([
+        f"head to the {goto.replace('_', ' ')} to see it firsthand",
+        f"go to the {goto.replace('_', ' ')} and do something about it",
+        f"use what they know as a {job} to help",
+        f"rally a neighbor and act on it together",
+        f"check on the people most affected first",
+    ])
+    understanding = "This changes things on the block — better to deal with it than ignore it."
+    return understanding, action, goto
+
+
+def _mock_react(character, event, mood, world):
+    char_name = character["name"]
+    mood_reactions = MOCK_REACTIONS.get(char_name, GENERIC_MOCK)
+    pool = mood_reactions.get(mood, mood_reactions.get("bored", ["Hmm. Interesting."]))
+
+    text = random.choice(pool)
+    drama = _compute_drama(text)
+
+    text, goto = _parse_goto(text)
+    understanding, action, brain_goto = _mock_brain(character, event, world)
+    if not goto:
+        goto = brain_goto
+
+    return {
+        "name": char_name,
+        "mood": mood,
+        "text": text,
+        "understanding": understanding,
+        "action": action,
+        "model": character["model"],
+        "drama": drama,
+        "moved_to": goto,
+        "vibe_delta": _compute_vibe_delta(mood),
+        "affinity_deltas": _compute_affinity_deltas(char_name, character, mood),
+    }
+
+
+def _real_react(character, event, mood, memory, relationships, world):
+    global _FAILURES, _CIRCUIT_OPEN_UNTIL
+    prompt = build_agent_prompt(character, event, mood, memory, relationships, world)
+
+    try:
+        import httpx
+
+        now = time.time()
+        if _CIRCUIT_OPEN_UNTIL > now:
+            _set_runtime_status("error", character["model"], "LLM error", None, "circuit breaker cooling down")
+            return _error_reaction(
+                character, mood,
+                f"model unreachable — retry after {int(_CIRCUIT_OPEN_UNTIL - now)}s",
+            )
+
+        payload = {
+            "event": event,
+            "characters": [character],
+            "prompts": {character["name"]: prompt},
+        }
+
+        data = None
+        last_error = None
+        for attempt in range(2):
+            try:
+                timeout = 180.0 if attempt == 0 else 45.0
+                _set_runtime_status("waking", character["model"], "Waking the model (~90s)", None)
+                start = time.time()
+                with httpx.Client(timeout=timeout, follow_redirects=True) as client:
+                    resp = client.post(MODAL_REACT_URL, json=payload)
+                    resp.raise_for_status()
+                    data = resp.json()
+                latency = round(time.time() - start, 2)
+                _FAILURES = 0
+                _set_runtime_status("live", character["model"], "Live", latency)
+                break
+            except Exception as e:
+                last_error = e
+                if attempt == 0:
+                    time.sleep(1.0)
+        if data is None:
+            raise last_error or RuntimeError("Modal request failed")
+
+        reactions = data.get("reactions", [])
+        if reactions and not reactions[0].get("error"):
+            raw = reactions[0]["text"]
+            text = _clean_line(raw)                       # real LLM dialogue, de-noised
+            if len(text) < 4:
+                return _error_reaction(character, mood, "model returned unusable text")
+            # movement + action are decided by the engine so a weak model can't break them
+            understanding, action, goto = _mock_brain(character, event, world)
+            drama = _compute_drama(text + " " + action)
+
+            return {
+                "name": character["name"],
+                "mood": mood,
+                "text": text,
+                "understanding": understanding,
+                "action": action,
+                "model": character["model"],
+                "drama": drama,
+                "moved_to": goto,
+                "vibe_delta": _compute_vibe_delta(mood),
+                "affinity_deltas": _compute_affinity_deltas(character["name"], character, mood),
+                "error": False,
+            }
+        message = reactions[0].get("text", "model unreachable") if reactions else "model unreachable"
+        raise RuntimeError(message)
+
+    except Exception as e:
+        _FAILURES += 1
+        if _FAILURES >= 3:
+            _CIRCUIT_OPEN_UNTIL = time.time() + 60.0
+        print(f"[agents] Modal call failed for {character['name']}: {e}")
+        _set_runtime_status("error", character["model"], "LLM error", None, str(e))
+        return _error_reaction(character, mood, f"model unreachable — retrying ({e})")
+
+
+def _set_runtime_status(mode, model, message, latency=None, error=None):
+    _RUNTIME_STATUS.update({
+        "mode": "mock" if MOCK else mode,
+        "model": "offline demo" if MOCK else (model or PRIMARY_MODEL),
+        "message": "Offline demo (mock)" if MOCK else message,
+        "latency": latency,
+        "error": error,
+    })
+
+
+def get_runtime_status():
+    if MOCK:
+        return {
+            "mode": "mock",
+            "model": "offline demo",
+            "message": "Offline demo (mock)",
+            "latency": None,
+            "error": None,
+        }
+    return dict(_RUNTIME_STATUS)
+
+
+def _error_reaction(character, mood, message):
+    return {
+        "name": character["name"],
+        "mood": mood,
+        "text": f"[{message}]",
+        "understanding": "The model call failed, so no in-character decision was produced.",
+        "action": "wait for the model to become reachable",
+        "model": character["model"],
+        "drama": 0.05,
+        "moved_to": None,
+        "vibe_delta": {"energy": 0.0, "social": 0.0},
+        "affinity_deltas": {},
+        "error": True,
+    }
+
+
+def _needs_from_vibes(world_id, name):
+    vibes = world_state.get_vibes(world_id).get(name, {"energy": 0.5, "social": 0.5})
+    return {
+        "energy": int(vibes.get("energy", 0.5) * 100),
+        "hunger": 45,
+        "social": int(vibes.get("social", 0.5) * 100),
+    }
+
+
+def _reaction_from_decision(character, decision):
+    vibe_delta = _compute_vibe_delta(decision.mood)
+    vibe_delta["energy"] += decision.need_deltas.get("energy", 0) / 100.0
+    vibe_delta["social"] += decision.need_deltas.get("social", 0) / 100.0
+    goto = None if decision.goto == "stay" else decision.goto
+    text = decision.say
+    if decision.degraded and decision.warning:
+        text = f"{text} [decision degraded: {decision.warning}]"
+    return {
+        "name": character["name"],
+        "mood": decision.mood,
+        "text": text,
+        "understanding": decision.think,
+        "action": decision.action,
+        "model": character["model"],
+        "drama": _compute_drama(f"{decision.say} {decision.action}"),
+        "moved_to": goto,
+        "vibe_delta": vibe_delta,
+        "affinity_deltas": _compute_affinity_deltas(character["name"], character, decision.mood),
+        "error": decision.error,
+        "degraded": decision.degraded,
+    }
+
+
+def _backend():
+    """Which inference backend to use: 'mock' (offline), 'local' (ZeroGPU in-process),
+    or 'modal' (HTTP to Modal, the default)."""
+    if MOCK:
+        return "mock"
+    return os.environ.get("TINYWORLD_INFER", "modal").lower()
+
+
+def _char_context(character, world):
+    wid = world["id"]
+    name = character["name"]
+    return {
+        "mood": world_state.get_mood(wid, name),
+        "memory": world_state.get_memory(wid, name),
+        "relationships": _format_relationships(character),
+        "position": world_state.get_position(wid, name) or character.get("home", "square"),
+        "needs": _needs_from_vibes(wid, name),
+    }
+
+
+def _finalize_reaction(character, world, result, route, event):
+    """Apply directed-command forcing, then persist mood + memory. Shared by every
+    backend so the engine behaves identically however the dialogue was produced."""
+    wid = world["id"]
+    forced_goto = (route or {}).get("goto")
+    hotspots = decide.allowed_hotspots(world)
+    if (route or {}).get("type") == "directed_command" and not result.get("error"):
+        if forced_goto in hotspots:
+            result["moved_to"] = forced_goto
+        # Surface the player's own instruction into the action so Crisis Mode's
+        # resolver can read what was ordered and obeyed — the small dialogue model
+        # often paraphrases the order and drops the keyword the resolver looks for.
+        instr = (route or {}).get("instruction", "")
+        base = result.get("action") or "follow the instruction"
+        if instr and instr.lower() not in base.lower():
+            result["action"] = f"{base} ({instr})"
+    elif forced_goto in hotspots and not result.get("error"):
+        result["moved_to"] = forced_goto
+
+    world_state.set_mood(wid, character["name"], result["mood"])
+    # learn from what they DID, not just what they said, so future reactions build on it
+    learned = result.get("action") or result["text"]
+    world_state.add_memory(wid, character["name"], event, learned)
+    return result
+
+
+def _react_one(character, event, world, route=None):
+    """One character via mock or Modal (per-call). The ZeroGPU path batches instead
+    — see _react_local."""
+    global _FAILURES, _CIRCUIT_OPEN_UNTIL
+    ctx = _char_context(character, world)
+    mood = ctx["mood"]
+
+    if MOCK:
+        decision_obj = decide.mock_decision(character, event, mood, world, route)
+        result = _reaction_from_decision(character, decision_obj)
+    else:
+        try:
+            now = time.time()
+            if _CIRCUIT_OPEN_UNTIL > now:
+                _set_runtime_status("error", character["model"], "LLM error", None, "circuit breaker cooling down")
+                return _error_reaction(
+                    character, mood,
+                    f"model unreachable — retry after {int(_CIRCUIT_OPEN_UNTIL - now)}s",
+                )
+            _set_runtime_status("waking", character["model"], "Waking the model (~90s)", None)
+            decision_obj = decide.decide_real(
+                character, event, mood, ctx["memory"], ctx["relationships"], world,
+                ctx["position"], ctx["needs"], route
+            )
+            _FAILURES = 0
+            _set_runtime_status("live", character["model"], "Live", decision_obj.latency)
+            result = _reaction_from_decision(character, decision_obj)
+        except Exception as e:
+            _FAILURES += 1
+            if _FAILURES >= 3:
+                _CIRCUIT_OPEN_UNTIL = time.time() + 60.0
+            print(f"[agents] Decision failed for {character['name']}: {e}")
+            _set_runtime_status("error", character["model"], "LLM error", None, str(e))
+            result = _error_reaction(character, mood, f"model unreachable — retrying ({e})")
+
+    return _finalize_reaction(character, world, result, route, event)
+
+
+def _react_local(cast, event, world, route=None):
+    """All characters in ONE ZeroGPU allocation: build every prompt, run a single
+    batched generate, then parse + finalize each. Avoids 5 separate GPU grabs."""
+    import inference  # heavy (torch/transformers); imported only on the local backend
+
+    contexts, prompts = {}, []
+    for ch in cast:
+        ctx = _char_context(ch, world)
+        contexts[ch["name"]] = ctx
+        prompts.append(decide.build_decision_prompt(
+            ch, event, ctx["mood"], ctx["memory"], ctx["relationships"],
+            world, ctx["position"], ctx["needs"], route))
+
+    try:
+        _set_runtime_status("waking", PRIMARY_MODEL, "Running on ZeroGPU…", None)
+        start = time.time()
+        raws = inference.generate_batch(prompts)
+        latency = round(time.time() - start, 2)
+        _set_runtime_status("live", PRIMARY_MODEL, "Live (ZeroGPU)", latency)
+    except Exception as e:
+        print(f"[agents] ZeroGPU batch failed: {e}")
+        _set_runtime_status("error", PRIMARY_MODEL, "GPU error", None, str(e))
+        return [_error_reaction(ch, contexts[ch["name"]]["mood"], f"GPU error ({e})") for ch in cast]
+
+    reactions = []
+    for ch, raw in zip(cast, raws):
+        decision = decide.parse_decision(raw, world, previous_mood=contexts[ch["name"]]["mood"])
+        result = _reaction_from_decision(ch, decision)
+        reactions.append(_finalize_reaction(ch, world, result, route, event))
+    return reactions
+
+
+def _format_relationships(character):
+    relationships = character.get("relationships", {})
+    if not relationships:
+        return "Relationships: nobody notable in this neighborhood yet."
+    parts = [f"{other_name} is your {relationship}" for other_name, relationship in relationships.items()]
+    return "Relationships: " + "; ".join(parts) + "."
+
+
+def react(world_id, event, mode="solo", route=None):
+    world = get_world(world_id)
+    if not world:
+        raise ValueError(f"Unknown world: {world_id}")
+
+    state = world_state.get_state(world_id)
+    world_state.init_cast(world)
+    world_state.increment_event(world_id)
+
+    target_names = set((route or {}).get("addressees") or [])
+    cast = [c for c in world["cast"] if not target_names or c["name"] in target_names]
+    if not cast:
+        cast = world["cast"]
+
+    if _backend() == "local":
+        # ZeroGPU: one batched GPU call for the whole cast.
+        reactions = _react_local(cast, event, world, route)
+    else:
+        with concurrent.futures.ThreadPoolExecutor(max_workers=5) as executor:
+            futures = {
+                executor.submit(_react_one, char, event, world, route): char
+                for char in cast
+            }
+            reactions = []
+            for future in concurrent.futures.as_completed(futures):
+                try:
+                    reactions.append(future.result())
+                except Exception as e:
+                    char = futures[future]
+                    print(f"[agents] error for {char['name']}: {e}")
+                    mood = world_state.get_mood(world_id, char["name"])
+                    reactions.append({
+                        "name": char["name"],
+                        "mood": mood,
+                        "text": f"[Something went wrong, but {char['name']} is still thinking...]",
+                        "model": char["model"],
+                        "drama": 0.1,
+                        "moved_to": None,
+                        "vibe_delta": {"energy": 0, "social": 0},
+                        "affinity_deltas": {},
+                    })
+
+    order = {c["name"]: i for i, c in enumerate(world["cast"])}
+    reactions.sort(key=lambda r: order.get(r["name"], 99))
+
+    for r in reactions:
+        world_state.apply_vibe_delta(world_id, r["name"], r["vibe_delta"])
+        world_state.apply_affinity_delta(world_id, r["name"], r["affinity_deltas"])
+        if r["moved_to"]:
+            world_state.set_position(world_id, r["name"], r["moved_to"])
+
+    town_delta = sum(r["vibe_delta"]["energy"] for r in reactions) / len(reactions)
+    current_town = world_state.get_town_mood(world_id)
+    world_state.set_town_mood(world_id, current_town + town_delta)
+
+    for c in cast:
+        if state["event_count"] % 3 == 0:
+            world_state.maybe_form_reflection(world_id, c["name"])
+
+    return {
+        "reactions": reactions,
+        "town_mood_delta": round(town_delta, 4),
+        "runtime": get_runtime_status(),
+    }
+
+
+def generate_followup(reactions, event):
+    if random.random() > 0.4:
+        return None
+
+    source = random.choice(reactions)
+    others = [r for r in reactions if r["name"] != source["name"]]
+    if not others:
+        return None
+    target = random.choice(others)
+
+    templates = [
+        f"Because {source['name']} reacted that way, {target['name']} quietly decides to keep an eye on them.",
+        f"{target['name']} overheard {source['name']}'s reaction and can't stop thinking about it.",
+        f"After hearing {source['name']}, {target['name']} changes their mind about the whole thing.",
+        f"{target['name']} wonders if {source['name']} knows something they're not saying.",
+        f"The look on {source['name']}'s face tells {target['name']} everything they need to know.",
+        f"{target['name']} files away {source['name']}'s reaction for later. That was... telling.",
+        f"While everyone else moves on, {target['name']} notices {source['name']} is still upset.",
+        f"{target['name']} wants to ask {source['name']} what they really think, but not in front of everyone.",
+    ]
+
+    return {
+        "type": "followup",
+        "source": source["name"],
+        "target": target["name"],
+        "text": random.choice(templates),
+        "mood": target["mood"],
+    }
+
+
+if __name__ == "__main__":
+    from worlds import get_world
+    w = get_world("maple_street")
+    world_state.init_cast(w)
+    result = react("maple_street", "A mysterious glowing object lands in the park")
+    for r in result["reactions"]:
+        print(f"{r['name']} | {r['mood']} | goto={r['moved_to']} | {r['text']}")
+    print(f"\nTown mood delta: {result['town_mood_delta']}")
+    followup = generate_followup(result["reactions"], "A mysterious glowing object lands in the park")
+    if followup:
+        print(f"\n[FOLLOWUP] {followup['text']}")

app.py

@@ -0,0 +1,698 @@
+import os
+import json
+import time
+import random
+import html
+import gradio as gr
+import agents
+import voice
+import transcribe
+import events
+import router
+import world_state
+import campaign
+from worlds import get_world, WORLDS, list_worlds
+
+MOCK = os.environ.get("TINYWORLD_MOCK", "0") == "1"
+
+MOOD_EMOJI = {
+    "happy": "😊", "stressed": "😰", "bored": "😐", "excited": "🤩",
+    "hungry": "🍕", "tired": "😴", "nostalgic": "🥹", "curious": "🧐",
+    "proud": "😤", "embarrassed": "🫣",
+}
+
+VIBE_COLORS = {
+    "energy": ("#ff6b6b", "#ffb15f"),
+    "hunger": ("#ffd76a", "#ff8a5f"),
+    "social": ("#38e8ff", "#9b6bff"),
+}
+
+CHAR_COLORS = {
+    "Marta Voss": "#ff5fa2", "Jay Park": "#ff8a5f", "Nia Okafor": "#7CFFB2",
+    "Luca Bell": "#38e8ff", "Priya Raman": "#9b6bff",
+}
+PALETTE = ["#ff5fa2", "#ff8a5f", "#7CFFB2", "#38e8ff", "#9b6bff"]
+
+
+def esc(value):
+    return html.escape(str(value), quote=True)
+
+
+def char_color(world, name):
+    for i, c in enumerate(world["cast"]):
+        if c["name"] == name:
+            return c.get("color") or CHAR_COLORS.get(name) or PALETTE[i % len(PALETTE)]
+    return "#9b6bff"
+
+
+# ---------------------------------------------------------------- canvas payloads
+def build_world_payload(world_id):
+    world = get_world(world_id)
+    board = world["board"]
+    cast = []
+    for c in world["cast"]:
+        home_key = c.get("home", "square")
+        tile = board["hotspots_tile"].get(home_key, [6, 6])
+        cast.append({
+            "name": c["name"], "short": c["name"].split()[0],
+            "emoji": c.get("emoji", "👤"),
+            "color": char_color(world, c["name"]),
+            "home": tile,
+        })
+    payload = {
+        "cols": board["cols"], "rows": board["rows"],
+        "roads": board["roads"], "plaza": board["plaza"],
+        "plaza_center": board.get("plaza_center", [board["cols"] / 2, board["rows"] / 2]),
+        "buildings": board["buildings"], "trees": board.get("trees", []),
+        "props": board.get("props", []), "cast": cast,
+        "hotspots": board.get("hotspots_tile", {}), "ambient": board.get("ambient", 12),
+    }
+    return json.dumps(payload)
+
+
+def build_reactions_payload(world_id, reactions):
+    world = get_world(world_id)
+    board = world["board"]
+    hs = board["hotspots_tile"]
+    acts = board.get("activities", {})
+    out = {"ts": time.time(), "reactions": []}
+    for r in reactions:
+        name = r["name"]
+        key = r.get("moved_to") or world_state.get_position(world_id, name)
+        act = acts.get(name, {})
+        action = (r.get("action") or "").strip()
+        short_action = (action[:24].rstrip() + "…") if len(action) > 25 else action
+        label = short_action or act.get("label", "")
+        vehicle = act.get("vehicle", "")
+        if key and key in hs:
+            tgt = hs[key]
+        else:
+            home = next((c.get("home") for c in world["cast"] if c["name"] == name), None)
+            tgt = hs.get(home) or hs.get("square") or [0, 0]
+        out["reactions"].append({
+            "name": name, "short": name.split()[0],
+            "mood": r["mood"], "moodEmoji": MOOD_EMOJI.get(r["mood"], "😐"),
+            "text": r["text"], "target": tgt, "activity": label, "vehicle": vehicle,
+            "running": False,
+        })
+    return json.dumps(out)
+
+
+def build_state_payload(world_id):
+    world = get_world(world_id)
+    board = world["board"]
+    hs = board["hotspots_tile"]
+    out = {"ts": time.time(), "silent": True, "reactions": []}
+    for c in world["cast"]:
+        name = c["name"]
+        key = world_state.get_position(world_id, name) or c.get("home", "square")
+        tile = hs.get(key) or hs.get(c.get("home")) or hs.get("square") or [0, 0]
+        mood = world_state.get_mood(world_id, name)
+        out["reactions"].append({
+            "name": name,
+            "short": name.split()[0],
+            "mood": mood,
+            "moodEmoji": MOOD_EMOJI.get(mood, "😐"),
+            "text": "",
+            "target": tile,
+            "activity": world_state.get_activity(world_id, name),
+            "vehicle": "",
+            "running": False,
+        })
+    return json.dumps(out)
+
+
+# ---------------------------------------------------------------- roster / ticker / log
+def render_vibe_bar(label, value, colors):
+    c1, c2 = colors
+    pct = int(value * 100)
+    return (
+        f'<div class="vibe-row"><span class="vibe-label">{label}</span>'
+        f'<div class="vibe-track"><div class="vibe-fill" style="width:{pct}%;'
+        f'background:linear-gradient(90deg,{c1},{c2});color:{c1}"></div></div>'
+        f'<span class="vibe-val">{pct}</span></div>'
+    )
+
+
+def render_roster(world_id):
+    world = get_world(world_id)
+    world_state.init_cast(world)
+    state = world_state.get_state(world_id)
+    needs = world_state.get_needs(world_id)
+    cards = []
+    for c in world["cast"]:
+        name = c["name"]
+        mood = state["moods"].get(name, "curious")
+        mood_e = MOOD_EMOJI.get(mood, "😐")
+        n = needs.get(name, {"energy": 60, "hunger": 35, "social": 50})
+        cards.append(
+            f'<div class="roster-card" style="border-left-color:{char_color(world, name)}">'
+            f'<div class="roster-emoji">{c.get("emoji", "👤")}</div>'
+            f'<div class="roster-name">{name.split()[0]}</div>'
+            f'<div class="roster-mood">{mood_e} {mood}</div>'
+            f'<div class="roster-meters">{render_vibe_bar("⚡", n["energy"] / 100, VIBE_COLORS["energy"])}'
+            f'{render_vibe_bar("🍽", n["hunger"] / 100, VIBE_COLORS["hunger"])}'
+            f'{render_vibe_bar("💬", n["social"] / 100, VIBE_COLORS["social"])}</div>'
+            f'</div>'
+        )
+    return f'<div class="roster-rail">{"".join(cards)}</div>'
+
+
+def render_ticker(world_id):
+    state = world_state.get_state(world_id)
+    day, game_time, paused = world_state.get_game_time(world_id)
+    chaos = state["chaos"]
+    filled = min(int(chaos * 5), 5)
+    bar = "▰" * filled + "▱" * (5 - filled)
+    unlocked = " 🔓" if chaos >= 0.5 else ""
+    return (
+        f'<div class="progress-ticker">'
+        f'<span class="ticker-day">DAY {day} · {world_state.format_time(game_time)}</span><span class="ticker-sep">·</span>'
+        f'<span class="ticker-events">{"PAUSED" if paused else "LIVE TIME"}</span><span class="ticker-sep">·</span>'
+        f'<span class="ticker-events">⚡ {state["event_count"]}</span><span class="ticker-sep">·</span>'
+        f'<span class="ticker-chaos">CHAOS {bar}{unlocked}</span></div>'
+    )
+
+
+def render_daily_log(world_id):
+    world = get_world(world_id)
+    timeline = world_state.get_timeline(world_id)
+    rows = []
+    for c in world["cast"]:
+        name = c["name"]
+        entries = timeline.get(name, [])[-4:]
+        text = " · ".join(esc(e) for e in entries) if entries else "No entries yet."
+        rows.append(
+            f'<div class="daily-row"><b style="color:{char_color(world, name)}">{esc(name.split()[0])}</b> '
+            f'<span>{text}</span></div>'
+        )
+    return f'<div class="daily-log-inner">{"".join(rows)}</div>'
+
+
+def render_mode_badge(status=None):
+    status = status or agents.get_runtime_status()
+    mode = status.get("mode")
+    model = status.get("model") or "unknown"
+    latency = status.get("latency")
+    error = status.get("error")
+    if mode == "live":
+        label = f"🟢 Live · {model.split('/')[-1]}"
+        if latency is not None:
+            label += f" · {latency:.1f}s"
+        cls = "mode-live"
+    elif mode == "waking":
+        label = f"🟡 Waking · {model.split('/')[-1]}"
+        cls = "mode-waking"
+    elif mode == "error":
+        msg = f" · {error}" if error else ""
+        label = f"🔴 LLM error{msg}"
+        cls = "mode-error"
+    else:
+        label = "🟡 Offline demo (mock)"
+        cls = "mode-mock"
+    return f'<div class="mode-badge {cls}">{esc(label)}</div>'
+
+
+def render_town_log(world_id, reactions=None, followup=None):
+    world = get_world(world_id)
+    if not reactions:
+        return ('<div class="town-log-inner"><div class="town-log-empty">'
+                'The town log is empty.<br>Throw an event to start the story.</div></div>')
+    lines = []
+    for r in reactions:
+        char = next((c for c in world["cast"] if c["name"] == r["name"]), None)
+        emoji = char.get("emoji", "👤") if char else "👤"
+        name = esc(r["name"])
+        text = esc(r["text"])
+        mood = esc(r["mood"])
+        lines.append(
+            f'<div class="log-entry"><div class="log-head">'
+            f'<span class="log-emoji">{emoji}</span><span class="log-name">{name}</span>'
+            f'<span class="log-mood">{MOOD_EMOJI.get(r["mood"], "😐")}</span></div>'
+            f'<div class="log-text" data-mood="{mood}">"{text}"</div></div>'
+        )
+    if followup:
+        lines.append(f'<div class="log-entry log-followup"><div class="log-text">🔗 <em>{esc(followup["text"])}</em></div></div>')
+    gossip_from = [r for r in reactions if random.random() < 0.3]
+    if gossip_from:
+        source = random.choice(gossip_from)
+        others = [c["name"] for c in world["cast"] if c["name"] != source["name"]]
+        if others:
+            target = random.choice(others)
+            snippet = source["text"][:60] + ("…" if len(source["text"]) > 60 else "")
+            lines.append(f'<div class="log-entry log-gossip"><div class="log-text">🗣️ '
+                         f'<em>Word spreads: {esc(target.split()[0])} hears "{esc(snippet)}"</em></div></div>')
+            world_state.add_gossip(world_id, target, snippet)
+    return f'<div class="town-log-inner">{"".join(lines)}</div>'
+
+
+def render_explainer(world_id, reactions=None, focus=None):
+    world = get_world(world_id)
+    if not reactions:
+        return ('<div class="explain-inner"><div class="explain-empty">'
+                'Pick a <b>scenario</b> or throw an event, then this panel explains '
+                '<b>why each person reacted the way they did</b> — great for teaching how '
+                'different people respond to the same situation.</div></div>')
+    parts = []
+    if focus:
+        parts.append(f'<div class="explain-focus">🎓 <b>Think about:</b> {esc(focus)}</div>')
+    else:
+        parts.append('<div class="explain-focus">🎓 <b>Why did they react this way?</b></div>')
+    for r in reactions:
+        c = next((x for x in world["cast"] if x["name"] == r["name"]), None)
+        if not c:
+            continue
+        trait = (c.get("traits") or ["distinct"])[0]
+        hint = c.get("catchphrase_hint", "responds in their own way")
+        col = char_color(world, r["name"])
+        understanding = esc((r.get("understanding") or "").strip())
+        action = esc((r.get("action") or "").strip())
+        first_name = esc(r["name"].split()[0])
+        mood = esc(r["mood"])
+        trait_text = esc(trait)
+        if understanding or action:
+            reason = (
+                f'reads it as: <em>{understanding}</em> ' if understanding else ''
+            ) + (
+                f'so they <b>{action}</b>.' if action else ''
+            )
+            parts.append(
+                f'<div class="explain-row"><b style="color:{col}">{first_name}</b> '
+                f'(feeling <em>{mood}</em>, naturally <em>{trait_text}</em>) {reason}</div>'
+            )
+        else:
+            parts.append(
+                f'<div class="explain-row"><b style="color:{col}">{first_name}</b> '
+                f'feels <em>{mood}</em> and is naturally <em>{trait_text}</em>, '
+                f'so they {esc(hint)}.</div>'
+            )
+    return f'<div class="explain-inner">{"".join(parts)}</div>'
+
+
+# ---------------------------------------------------------------- crisis mode UI
+def render_crisis_hud(world_id):
+    v = campaign.view(get_world(world_id))
+    cr = v["crisis"]
+    if not v["active"] or not cr:
+        return '<div class="crisis-hud crisis-hud-idle">No crisis active — switch to 🎬 Campaign and press <b>Start Campaign</b>.</div>'
+    chips = []
+    for req in cr["requirements"]:
+        cls = "met" if req["met"] else "open"
+        icon = "✅" if req["met"] else "⏳"
+        opt = " (optional)" if req["optional"] else ""
+        chips.append(f'<span class="crisis-chip {cls}">{icon} {esc(req["label"])}{esc(opt)}</span>')
+    chaos_pct = int(v["chaos"] * 100)
+    res = int(v["town_resilience"])
+    return (
+        f'<div class="crisis-hud">'
+        f'<div class="crisis-top"><span class="crisis-title">🚨 {esc(cr["title"])}</span>'
+        f'<span class="crisis-meta">Chapter {v["chapter_index"] + 1}/{v["chapter_count"]} · '
+        f'Round {cr["round"]}/{cr["time_limit"]}</span></div>'
+        f'<div class="crisis-chips">{"".join(chips)}</div>'
+        f'<div class="crisis-bars">'
+        f'<div class="crisis-bar"><span>🔥 Chaos</span><div class="cbar-track">'
+        f'<div class="cbar-fill chaos" style="width:{chaos_pct}%"></div></div><b>{chaos_pct}</b></div>'
+        f'<div class="crisis-bar"><span>🛡 Resilience</span><div class="cbar-track">'
+        f'<div class="cbar-fill res" style="width:{res}%"></div></div><b>{res}</b></div>'
+        f'</div></div>'
+    )
+
+
+def render_story_card(kind="dispatch", title="", body="", extra=""):
+    if not title and not body and not extra:
+        return '<div class="story-card story-hidden"></div>'
+    title_html = f'<div class="story-title">{esc(title)}</div>' if title else ""
+    body_html = f'<div class="story-body">{esc(body)}</div>' if body else ""
+    return f'<div class="story-card story-{kind}">{title_html}{body_html}{extra}</div>'
+
+
+def build_crisis_payload(world_id):
+    world = get_world(world_id)
+    v = campaign.view(world)
+    cr = v["crisis"]
+    out = {"ts": time.time(), "active": bool(v["active"] and cr),
+           "status": v["status"], "chaos": v["chaos"]}
+    if cr:
+        hs = world["board"]["hotspots_tile"]
+        out.update({
+            "kind": cr["kind"], "title": cr["title"],
+            "tile": hs.get(cr["affected_hotspot"]) if cr["affected_hotspot"] else None,
+            "round": cr["round"], "time_limit": cr["time_limit"],
+            "requirements": [{"id": r["id"], "label": r["label"], "met": r["met"]}
+                             for r in cr["requirements"]],
+        })
+    return json.dumps(out)
+
+
+def _outcome_card(res):
+    oc = res.get("outcome")
+    grade = res.get("grade")
+    if oc == "won":
+        return render_story_card("win", f"✅ Chapter cleared · Grade {grade}", res.get("outro", ""))
+    if oc == "lost_crisis":
+        return render_story_card("loss", f"❌ Chapter failed · Grade {grade}", res.get("outro", ""))
+    if oc == "campaign_lost":
+        return render_story_card("gameover", "🏚 The town fell",
+                                 f'{res.get("outro", "")} Town Resilience hit zero.')
+    if oc == "finale":
+        extra = f'<div class="story-reveal">{esc(res.get("reveal", ""))}</div>'
+        return render_story_card("finale", "🎬 The Long Summer — Finale", res.get("outro", ""), extra)
+    return render_story_card("dispatch", "", res.get("dispatch", ""))
+
+
+def scenario_choices(world_id):
+    world = get_world(world_id)
+    return [(s["title"], s["id"]) for s in world.get("scenarios", [])]
+
+
+def render_stage_shell():
+    return '<div class="stage" id="tw-stage"><canvas id="tw-canvas"></canvas><div class="stage-vignette"></div></div>'
+
+
+# ---------------------------------------------------------------- assets
+def _read(path):
+    full = os.path.join(os.path.dirname(__file__), path)
+    if os.path.exists(full):
+        with open(full) as f:
+            return f.read()
+    return ""
+
+
+css_content = _read("assets/style.css")
+js_content = _read("assets/game.js")
+
+# Force dark mode on load. HF Spaces otherwise loads light mode, which renders
+# Gradio's dark text on top of our neon-dark panels — unreadable. With ?__theme=dark
+# Gradio uses its light-on-dark palette and everything is legible.
+THEME_JS = (
+    "(function(){try{var u=new URL(window.location.href);"
+    "if(u.searchParams.get('__theme')!=='dark'){"
+    "u.searchParams.set('__theme','dark');window.location.replace(u.href);}}catch(e){}})();\n"
+)
+js_content = THEME_JS + js_content
+
+DEFAULT_WORLD = os.environ.get("TW_DEFAULT_WORLD", "maple_street")
+world_list = list_worlds()
+world_names = {w["id"]: w["name"] for w in world_list}
+
+
+# ---------------------------------------------------------------- UI
+with gr.Blocks(title="TinyWorld — AI Neighborhood Game") as demo:
+    current_world_id = gr.State(DEFAULT_WORLD)
+    last_reactions_state = gr.State([])
+
+    with gr.Row():
+        with gr.Column(scale=7):
+            gr.HTML('<div class="tw-topbar"><div class="tw-logo">TINYWORLD</div>'
+                    '<div class="tw-tagline">the town that remembers</div></div>')
+        with gr.Column(scale=2, min_width=160):
+            world_picker = gr.Dropdown(
+                choices=[(world_names.get(w["id"], w["id"]), w["id"]) for w in world_list],
+                value=DEFAULT_WORLD, label="World")
+        with gr.Column(scale=3, min_width=210):
+            ticker_html = gr.HTML(render_ticker(DEFAULT_WORLD))
+        with gr.Column(scale=2, min_width=210):
+            mode_badge_html = gr.HTML(render_mode_badge())
+
+    # the canvas stage (rendered once, never re-rendered → game loop persists)
+    gr.HTML(render_stage_shell())
+
+    # hidden data channels for the canvas
+    world_box = gr.Textbox(value=build_world_payload(DEFAULT_WORLD), elem_id="tw-world",
+                           elem_classes="tw-data", label="", interactive=True)
+    reactions_box = gr.Textbox(value="", elem_id="tw-reactions", elem_classes="tw-data",
+                               label="", interactive=True)
+    crisis_box = gr.Textbox(value=build_crisis_payload(DEFAULT_WORLD), elem_id="tw-crisis",
+                            elem_classes="tw-data", label="", interactive=True)
+
+    with gr.Row(elem_id="tw-console"):
+        with gr.Column(scale=8):
+            event_input = gr.Textbox(
+                placeholder="Type an event to throw at the neighborhood…  (e.g. a UFO lands in the park)",
+                label="", show_label=False, lines=1)
+        with gr.Column(scale=2, min_width=150):
+            trigger_btn = gr.Button("⚡ THROW", variant="primary", elem_id="throw-btn")
+
+    with gr.Row(elem_id="tw-actions"):
+        with gr.Column(scale=6, min_width=260):
+            scenario_dd = gr.Dropdown(choices=scenario_choices(DEFAULT_WORLD), value=None,
+                                      label="🎓 Teaching scenario — a real situation to explore")
+        with gr.Column(scale=2, min_width=140):
+            run_scenario_btn = gr.Button("🎓 Run Scenario")
+        with gr.Column(scale=2, min_width=140):
+            random_btn = gr.Button("🎲 Random Chaos")
+        with gr.Column(scale=1, min_width=120):
+            pause_btn = gr.Button("⏯ Time")
+        with gr.Column(scale=1, min_width=120):
+            step_btn = gr.Button("⏭ Step")
+
+    with gr.Row(elem_id="tw-mode"):
+        with gr.Column(scale=5, min_width=240):
+            mode_radio = gr.Radio(
+                ["🧪 Sandbox", "🎬 Campaign"], value="🧪 Sandbox",
+                label="Mode", show_label=True)
+        with gr.Column(scale=2, min_width=160):
+            start_campaign_btn = gr.Button("🎬 Start Campaign", variant="primary")
+        with gr.Column(scale=2, min_width=160):
+            next_round_btn = gr.Button("▶ Play Round")
+
+    crisis_hud_html = gr.HTML(render_crisis_hud(DEFAULT_WORLD))
+    story_card_html = gr.HTML(render_story_card())
+
+    with gr.Row(equal_height=False):
+        with gr.Column(scale=3, min_width=220):
+            gr.HTML('<div class="panel-title">🧑‍🤝‍🧑 Townsfolk</div>')
+            roster_html = gr.HTML(render_roster(DEFAULT_WORLD))
+        with gr.Column(scale=4, min_width=240):
+            gr.HTML('<div class="panel-title">📜 Town Log</div>')
+            town_log_html = gr.HTML(render_town_log(DEFAULT_WORLD))
+        with gr.Column(scale=4, min_width=240):
+            gr.HTML('<div class="panel-title">🎓 Learn — Why did they react?</div>')
+            explainer_html = gr.HTML(render_explainer(DEFAULT_WORLD))
+
+    gr.HTML('<div class="panel-title" style="margin-top:6px">🕒 Daily Log</div>')
+    daily_log_html = gr.HTML(render_daily_log(DEFAULT_WORLD))
+
+    gr.HTML('<div class="panel-title" style="margin-top:6px">🔊 Voice</div>')
+    with gr.Row(elem_id="tw-audio", equal_height=False):
+        with gr.Column(scale=4, min_width=240):
+            mic_input = gr.Audio(sources=["microphone"], type="filepath", label="🎙️ 1 · Record your event")
+            transcribe_btn = gr.Button("📝 2 · Transcribe to text")
+            mic_status = gr.HTML('<div class="audio-cap">Record → press <b>Transcribe</b>: your words fill the '
+                                 'event box, then press <b>⚡ THROW</b>. <i>Mic only works on '
+                                 'http://localhost:7860 (blocked on 0.0.0.0).</i></div>')
+        with gr.Column(scale=4, min_width=240):
+            voice_output = gr.Audio(label="🔊 Auto-voice (plays after each event)", autoplay=True)
+            gr.HTML('<div class="audio-cap">The <b>most dramatic</b> reaction is read aloud automatically.</div>')
+        with gr.Column(scale=4, min_width=240):
+            hear_name = gr.Dropdown(choices=[], label="🎧 Replay a character's voice")
+            hear_btn = gr.Button("▶ Play their last line")
+            gr.HTML('<div class="audio-cap">Pick any character and hear their <b>last line</b> again.</div>')
+
+    gr.HTML('<div class="tw-footer">Built for <strong>Build Small Hackathon 2026</strong> · '
+            'Hugging Face × Gradio · Thousand Token Wood<br>'
+            'Models: <strong>Nemotron-Mini-4B</strong> (NVIDIA) + <strong>VoxCPM2</strong> (OpenBMB) · '
+            '<strong>Whisper on Modal</strong> speech-to-text, Cohere fallback · <strong>Modal</strong><br>'
+            '<span class="footer-muted">Switch maps with the <b>World</b> picker, top-right · '
+            'open at <b>http://localhost:7860</b> for microphone access.</span></div>')
+    tick_timer = gr.Timer(value=float(os.environ.get("TINYWORLD_TIME_SCALE", "6")), active=True)
+
+    # ---------------------------------------------------------- handlers
+    def _run_event(world_id, event_text, focus=None, route=None):
+        world = get_world(world_id)
+        world_state.init_cast(world)
+        result = agents.react(world_id, event_text, route=route)
+        reactions = result["reactions"]
+        runtime = result.get("runtime") or agents.get_runtime_status()
+        followup = agents.generate_followup(reactions, event_text)
+        top = max(reactions, key=lambda r: r["drama"])
+        audio = None
+        try:
+            cd = next(c for c in world["cast"] if c["name"] == top["name"])
+            audio = voice.generate_voice(top["text"], cd["voice_description"])
+        except Exception as e:
+            print(f"[app] voice failed: {e}")
+        names = [r["name"] for r in reactions]
+        return (render_town_log(world_id, reactions, followup), render_roster(world_id),
+                render_ticker(world_id), audio,
+                gr.Dropdown(choices=names, value=names[0] if names else None),
+                reactions, build_reactions_payload(world_id, reactions),
+                render_explainer(world_id, reactions, focus), render_mode_badge(runtime),
+                render_daily_log(world_id))
+
+    def _sandbox_tail(world_id):
+        # the three campaign outputs in their idle/passthrough state for sandbox events
+        return (render_crisis_hud(world_id), render_story_card(), build_crisis_payload(world_id))
+
+    def _empty_sandbox(world_id):
+        return (render_town_log(world_id), render_roster(world_id), render_ticker(world_id),
+                None, gr.Dropdown(choices=[], value=None), [], "", render_explainer(world_id),
+                render_mode_badge(), render_daily_log(world_id)) + _sandbox_tail(world_id)
+
+    def _sandbox_throw(event_text, world_id):
+        if not event_text or not event_text.strip():
+            return _empty_sandbox(world_id)
+        world = get_world(world_id)
+        route = router.classify(event_text.strip(), world)
+        if route["type"] == "noop":
+            return _empty_sandbox(world_id)
+        return _run_event(world_id, event_text.strip(), route=route) + _sandbox_tail(world_id)
+
+    def do_throw(event_text, world_id, mode):
+        v = campaign.view(get_world(world_id))
+        if str(mode).startswith("🎬") and v["active"] and v["status"] == "playing":
+            return _run_crisis_round(world_id, event_text)
+        return _sandbox_throw(event_text, world_id)
+
+    def start_campaign(world_id):
+        world = get_world(world_id)
+        world_state.reset_world(world_id)
+        world_state.init_cast(world)
+        v = campaign.start(world)
+        card = render_story_card("intro", f"🎬 {v['title']}", v.get("chapter_intro", ""))
+        return (render_town_log(world_id), render_roster(world_id), render_ticker(world_id),
+                None, gr.Dropdown(choices=[], value=None), [], build_state_payload(world_id),
+                render_explainer(world_id), render_mode_badge(), render_daily_log(world_id),
+                render_crisis_hud(world_id), card, build_crisis_payload(world_id))
+
+    def _run_crisis_round(world_id, player_text):
+        world = get_world(world_id)
+        v0 = campaign.view(world)
+        if not v0["active"] or not v0["crisis"] or v0["status"] != "playing":
+            return (render_town_log(world_id), render_roster(world_id), render_ticker(world_id),
+                    None, gr.Dropdown(choices=[], value=None), [], build_state_payload(world_id),
+                    render_explainer(world_id), render_mode_badge(), render_daily_log(world_id),
+                    render_crisis_hud(world_id),
+                    render_story_card("dispatch", "", "No active crisis — press Start Campaign."),
+                    build_crisis_payload(world_id))
+
+        cr = campaign.current_crisis(world)
+        focus = cr.focus if cr else ""
+        event_text = campaign.round_event_text(world)
+        route = None
+        if player_text and player_text.strip():
+            r = router.classify(player_text.strip(), world)
+            if r["type"] != "noop":
+                route = r
+
+        result = agents.react(world_id, event_text, route=route)
+        reactions = result["reactions"]
+        runtime = result.get("runtime") or agents.get_runtime_status()
+        res = campaign.resolve_round(world, reactions)
+
+        audio = None
+        if reactions:
+            top = max(reactions, key=lambda r: r["drama"])
+            try:
+                cd = next(c for c in world["cast"] if c["name"] == top["name"])
+                audio = voice.generate_voice(top["text"], cd["voice_description"])
+            except Exception as e:
+                print(f"[app] voice failed: {e}")
+
+        names = [r["name"] for r in reactions]
+        dispatch = {"text": res.get("dispatch", "")} if res.get("dispatch") else None
+        return (render_town_log(world_id, reactions, dispatch), render_roster(world_id),
+                render_ticker(world_id), audio,
+                gr.Dropdown(choices=names, value=names[0] if names else None),
+                reactions, build_reactions_payload(world_id, reactions),
+                render_explainer(world_id, reactions, focus), render_mode_badge(runtime),
+                render_daily_log(world_id), render_crisis_hud(world_id),
+                _outcome_card(res), build_crisis_payload(world_id))
+
+    def run_scenario(scenario_id, world_id):
+        world = get_world(world_id)
+        scen = next((s for s in world.get("scenarios", []) if s["id"] == scenario_id), None)
+        if not scen:
+            return (gr.update(), gr.update(), gr.update(), gr.update(), gr.update(),
+                    gr.update(), gr.update(), gr.update(), gr.update(), gr.update(), gr.update())
+        route = {"type": "world_event", "text": scen["event"], "instruction": scen["event"], "addressees": [], "goto": None}
+        return (scen["event"],) + _run_event(world_id, scen["event"], scen.get("focus"), route)
+
+    def random_chaos(world_id):
+        world = get_world(world_id)
+        if world and world.get("events"):
+            return random.choice(world["events"])
+        return events.random_event()
+
+    def switch_world(world_id):
+        world = get_world(world_id)
+        if world:
+            world_state.reset_world(world_id)
+            world_state.init_cast(world)
+        return (build_world_payload(world_id), "", render_town_log(world_id),
+                render_roster(world_id), render_ticker(world_id),
+                gr.Dropdown(choices=scenario_choices(world_id), value=None),
+                render_explainer(world_id), world_id, render_mode_badge(), render_daily_log(world_id),
+                render_crisis_hud(world_id), render_story_card(), build_crisis_payload(world_id))
+
+    def sim_tick(world_id):
+        world = get_world(world_id)
+        if world:
+            world_state.tick(world, hours=1.0)
+        return (render_ticker(world_id), render_roster(world_id),
+                build_state_payload(world_id), render_daily_log(world_id))
+
+    def toggle_time(world_id):
+        _, _, paused = world_state.get_game_time(world_id)
+        world_state.set_paused(world_id, not paused)
+        return sim_tick(world_id)
+
+    def step_time(world_id):
+        world = get_world(world_id)
+        if world:
+            world_state.tick(world, hours=1.0, force=True)
+        return (render_ticker(world_id), render_roster(world_id),
+                build_state_payload(world_id), render_daily_log(world_id))
+
+    def transcribe_audio(audio_path):
+        if not audio_path:
+            return ("", '<div class="audio-cap">⚠ No recording found — press the mic ● record button first. '
+                    '<i>The mic only works on http://localhost:7860.</i></div>')
+        text = transcribe.transcribe(audio_path)
+        if not text:
+            return ("", '<div class="audio-cap">⚠ Could not transcribe. Try again, or just type the event.</div>')
+        return (text, f'<div class="audio-cap">✅ Heard: "<b>{esc(text)}</b>" — now press <b>⚡ THROW</b>.</div>')
+
+    def hear_reaction(name, world_id, reactions):
+        if not reactions or not name:
+            return None
+        rx = next((r for r in reactions if r["name"] == name), None)
+        if not rx:
+            return None
+        world = get_world(world_id)
+        try:
+            cd = next(c for c in world["cast"] if c["name"] == name)
+            return voice.generate_voice(rx["text"], cd["voice_description"])
+        except Exception as e:
+            print(f"[app] hear failed: {e}")
+            return None
+
+    def play_round(world_id):
+        return _run_crisis_round(world_id, "")
+
+    trig_out = [town_log_html, roster_html, ticker_html, voice_output,
+                hear_name, last_reactions_state, reactions_box, explainer_html, mode_badge_html,
+                daily_log_html]
+    full_out = trig_out + [crisis_hud_html, story_card_html, crisis_box]
+    trigger_btn.click(do_throw, [event_input, current_world_id, mode_radio], full_out)
+    event_input.submit(do_throw, [event_input, current_world_id, mode_radio], full_out)
+    start_campaign_btn.click(start_campaign, [current_world_id], full_out)
+    next_round_btn.click(play_round, [current_world_id], full_out)
+    run_scenario_btn.click(run_scenario, [scenario_dd, current_world_id], [event_input] + trig_out)
+    random_btn.click(random_chaos, [current_world_id], [event_input])
+    transcribe_btn.click(transcribe_audio, [mic_input], [event_input, mic_status])
+    hear_btn.click(hear_reaction, [hear_name, current_world_id, last_reactions_state], [voice_output])
+    world_picker.change(switch_world, [world_picker],
+                        [world_box, reactions_box, town_log_html, roster_html, ticker_html,
+                         scenario_dd, explainer_html, current_world_id, mode_badge_html, daily_log_html,
+                         crisis_hud_html, story_card_html, crisis_box])
+    pause_btn.click(toggle_time, [current_world_id], [ticker_html, roster_html, reactions_box, daily_log_html])
+    step_btn.click(step_time, [current_world_id], [ticker_html, roster_html, reactions_box, daily_log_html])
+    tick_timer.tick(sim_tick, [current_world_id], [ticker_html, roster_html, reactions_box, daily_log_html])
+
+
+if __name__ == "__main__":
+    port = int(os.environ.get("GRADIO_SERVER_PORT", "7860"))
+    print("\n  TinyWorld is starting…")
+    print(f"  ▶ Open  http://localhost:{port}   (use localhost, not 0.0.0.0, so the mic works)\n")
+    demo.launch(server_name="0.0.0.0", server_port=port, css=css_content, js=js_content or None)

assets/game.js

@@ -0,0 +1,646 @@
+// TinyWorld — canvas isometric town: futuristic buildings, park, fountain,
+// steering-physics characters that spread to in-character destinations.
+// Data in via hidden textareas: #tw-world (board+cast, hot-swappable for map
+// switching) and #tw-reactions (per-throw, polled).
+(function () {
+  function $(s) { return document.querySelector(s); }
+  function txt(s) { var e = $(s + ' textarea') || $(s + ' input'); return e ? e.value : ''; }
+
+  function micBanner() {
+    if (document.getElementById('tw-mic-warn')) return;
+    if (location.hostname === '0.0.0.0' || (location.protocol !== 'https:' && location.hostname !== 'localhost' && location.hostname !== '127.0.0.1')) {
+      var b = document.createElement('div'); b.id = 'tw-mic-warn'; b.className = 'tw-mic-warn';
+      var port = location.port ? ':' + location.port : '';
+      b.innerHTML = '⚠ For the microphone, open <b>http://localhost' + port + '</b> — voice input is blocked on this address (' + location.hostname + '). Typing works everywhere.';
+      document.body.appendChild(b);
+    }
+  }
+
+  function boot() {
+    var canvas = document.getElementById('tw-canvas');
+    if (!canvas) return setTimeout(boot, 200);
+    micBanner();
+    if (window.__TW) return;
+    window.__TW = engine(canvas);
+    window.__TW.start();
+  }
+
+  function engine(canvas) {
+    var ctx = canvas.getContext('2d');
+    var DPR = Math.min(window.devicePixelRatio || 1, 2);
+    var TS = 64, TH = 32;
+    var S = { W: null, raw: '', chars: [], tiles: {}, scale: 1, ox: 0, oy: 0, waves: [], lastTs: 0, crisis: null, crisisTs: 0 };
+
+    function shade(hex, f) {
+      var n = parseInt(hex.slice(1), 16), r = (n >> 16) & 255, g = (n >> 8) & 255, b = n & 255;
+      r = Math.min(255, r * f); g = Math.min(255, g * f); b = Math.min(255, b * f);
+      return 'rgb(' + (r | 0) + ',' + (g | 0) + ',' + (b | 0) + ')';
+    }
+    function iso(gx, gy) { return { x: S.ox + (gx - gy) * (TS / 2) * S.scale, y: S.oy + (gx + gy) * (TH / 2) * S.scale }; }
+
+    function loadWorld(W) {
+      S.W = W; S.tiles = {};
+      (W.roads.cols || []).forEach(function (c) { for (var r = 0; r < W.rows; r++) S.tiles[c + ',' + r] = 'road'; });
+      (W.roads.rows || []).forEach(function (r) { for (var c = 0; c < W.cols; c++) S.tiles[c + ',' + r] = 'road'; });
+      (W.plaza || []).forEach(function (p) { S.tiles[p[0] + ',' + p[1]] = 'plaza'; });
+      S.chars = W.cast.map(function (c) {
+        return {
+          name: c.name, short: c.short, emoji: c.emoji, color: c.color,
+          x: c.home[0], y: c.home[1], vx: 0, vy: 0, tx: c.home[0], ty: c.home[1], home: c.home.slice(),
+          moodEmoji: '', bubble: null, bubbleAt: 0, speaking: false, activity: '', vehicle: '', running: false,
+          idle: 1 + Math.random() * 4, bob: Math.random() * 6, returnAt: 0
+        };
+      });
+      S.spots = (W.hotspots ? Object.keys(W.hotspots).map(function (k) { return W.hotspots[k]; }) : []);
+      // ---- physics: tiles nobody can walk into (buildings, water, tree trunks) ----
+      S.blocked = {};
+      function block(gx, gy) { S.blocked[Math.round(gx) + ',' + Math.round(gy)] = 1; }
+      W.buildings.forEach(function (b) { for (var bx = b.gx; bx < b.gx + b.w; bx++) for (var by = b.gy; by < b.gy + b.d; by++) block(bx, by); });
+      (W.props || []).forEach(function (p) {
+        if (p.type === 'pond') { for (var px = 0; px < (p.w || 2); px++) for (var py = 0; py < (p.d || 2); py++) block(p.gx + px, p.gy + py); }
+        else if (p.type === 'fountain') { block(p.gx, p.gy); block(p.gx - 0.5, p.gy - 0.5); block(p.gx + 0.5, p.gy + 0.5); }
+      });
+      (W.trees || []).forEach(function (t) { block(t[0], t[1]); });
+      // never trap a character: a home/spawn tile stays walkable even if it overlaps scenery
+      S.chars.forEach(function (c) { delete S.blocked[Math.round(c.home[0]) + ',' + Math.round(c.home[1])]; });
+      // seats people can amble over to and rest at, so the town isn't a permanent jog
+      S.seats = [];
+      (W.props || []).forEach(function (p) { if (p.type === 'bench' || p.type === 'patio' || p.type === 'table') S.seats.push([Math.round(p.gx), Math.round(p.gy) + 1]); });
+      // ambient crowd — pedestrians, a cyclist, dogs that bring the town to life
+      var SHIRTS = ['#c85a54', '#4a7bc8', '#caa23f', '#5aa86a', '#8a6fc0', '#c86fa0', '#3f9c9c', '#b5703f'];
+      var HAIR = ['#2a2018', '#4a3526', '#6b6b6b', '#161616', '#5a3a22', '#3a2a40', '#7a6a55'];
+      var n = (W.ambient != null) ? W.ambient : 6;
+      S.amb = [];
+      for (var i = 0; i < n; i++) {
+        var t = randWalkable();
+        var type = (i % 6 === 0) ? 'dog' : ((i % 6 === 1) ? 'bike' : 'ped');
+        S.amb.push({
+          type: type, x: t[0], y: t[1], vx: 0, vy: 0, tx: t[0], ty: t[1],
+          sp: (type === 'bike' ? 1.0 : 0.5) + Math.random() * 0.4,
+          idle: Math.random() * 3, ph: Math.random() * 6, face: 1,
+          shirt: SHIRTS[i % SHIRTS.length], hair: HAIR[i % HAIR.length],
+          sc: (type === 'dog' ? 0.85 : 1.1),
+          follow: type === 'dog' ? Math.floor(Math.random() * S.chars.length) : -1
+        });
+      }
+      // cars are off unless a world opts in (W.traffic), and they cruise slowly when on
+      var CARC = ['#d24b4b', '#3f6fb0', '#d6b13f', '#4a9c6a', '#8a8f9c'], ci = 0;
+      S.cars = [];
+      if (W.traffic) {
+        (W.roads.rows || []).forEach(function (r) { S.cars.push({ axis: 'h', line: r, pos: Math.random() * W.cols, dir: Math.random() < 0.5 ? 1 : -1, sp: 0.5 + Math.random() * 0.3, color: CARC[ci++ % CARC.length] }); });
+        (W.roads.cols || []).forEach(function (c) { S.cars.push({ axis: 'v', line: c, pos: Math.random() * W.rows, dir: Math.random() < 0.5 ? 1 : -1, sp: 0.5 + Math.random() * 0.3, color: CARC[ci++ % CARC.length] }); });
+      }
+      S.waves = [];
+      fit();
+    }
+
+    function randWalkable() {
+      for (var k = 0; k < 30; k++) { var gx = Math.floor(Math.random() * S.W.cols), gy = Math.floor(Math.random() * S.W.rows); if (walkable(gx, gy)) return [gx, gy]; }
+      return [S.W.cols >> 1, S.W.rows >> 1];
+    }
+
+    function fit() {
+      if (!S.W) return;
+      var rect = canvas.getBoundingClientRect();
+      canvas.width = Math.max(1, rect.width * DPR); canvas.height = Math.max(1, rect.height * DPR);
+      var minX = 1e9, maxX = -1e9, minY = 1e9, maxY = -1e9;
+      for (var gy = 0; gy <= S.W.rows; gy++) for (var gx = 0; gx <= S.W.cols; gx++) {
+        var x = (gx - gy) * TS / 2, y = (gx + gy) * TH / 2;
+        if (x < minX) minX = x; if (x > maxX) maxX = x; if (y < minY) minY = y; if (y > maxY) maxY = y;
+      }
+      var bw = maxX - minX, bh = (maxY - minY) + 130;
+      S.scale = Math.min(rect.width / bw, rect.height / bh) * 1.06;
+      S.ox = rect.width / 2 - ((minX + maxX) / 2) * S.scale;
+      S.oy = rect.height / 2 - ((minY + maxY) / 2) * S.scale + 18 * S.scale;
+    }
+    window.addEventListener('resize', fit);
+
+    function walkable(gx, gy) {
+      gx = Math.round(gx); gy = Math.round(gy);
+      if (gx < 0 || gy < 0 || gx >= S.W.cols || gy >= S.W.rows) return false;
+      return !(S.blocked && S.blocked[gx + ',' + gy]);
+    }
+
+    // ---------- tiles ----------
+    function drawTile(gx, gy) {
+      var t = S.tiles[gx + ',' + gy] || 'grass';
+      var a = iso(gx, gy), b = iso(gx + 1, gy), c = iso(gx + 1, gy + 1), d = iso(gx, gy + 1);
+      ctx.beginPath(); ctx.moveTo(a.x, a.y); ctx.lineTo(b.x, b.y); ctx.lineTo(c.x, c.y); ctx.lineTo(d.x, d.y); ctx.closePath();
+      var fill = ((gx + gy) % 2 === 0) ? '#1e6b3e' : '#1a6038';
+      if (t === 'road') fill = ((gx + gy) % 2 === 0) ? '#33384c' : '#2e3344';
+      else if (t === 'plaza') fill = '#46415f';
+      ctx.fillStyle = fill; ctx.fill();
+      ctx.strokeStyle = 'rgba(120,200,255,0.07)'; ctx.lineWidth = 1; ctx.stroke();
+      if (t === 'road') {
+        ctx.strokeStyle = 'rgba(255,215,106,0.45)'; ctx.lineWidth = Math.max(1, 1.6 * S.scale);
+        ctx.setLineDash([5 * S.scale, 5 * S.scale]); ctx.beginPath();
+        ctx.moveTo((a.x + d.x) / 2, (a.y + d.y) / 2); ctx.lineTo((b.x + c.x) / 2, (b.y + c.y) / 2);
+        ctx.stroke(); ctx.setLineDash([]);
+      }
+    }
+
+    // ---------- buildings ----------
+    function corners(b, H) {
+      var bt = iso(b.gx, b.gy), br = iso(b.gx + b.w, b.gy), bb = iso(b.gx + b.w, b.gy + b.d), bl = iso(b.gx, b.gy + b.d);
+      return { bt: bt, br: br, bb: bb, bl: bl, tt: u(bt, H), tr: u(br, H), tb: u(bb, H), tl: u(bl, H) };
+      function u(p, h) { return { x: p.x, y: p.y - h }; }
+    }
+    function quad(p0, p1, p2, p3, fill) { ctx.fillStyle = fill; ctx.beginPath(); ctx.moveTo(p0.x, p0.y); ctx.lineTo(p1.x, p1.y); ctx.lineTo(p2.x, p2.y); ctx.lineTo(p3.x, p3.y); ctx.closePath(); ctx.fill(); }
+    // p0=base-near, p1=base-far, p2=top-far, p3=top-near
+    function onQuad(p0, p1, p2, p3, u, v) {
+      var ax = p0.x + (p1.x - p0.x) * u, ay = p0.y + (p1.y - p0.y) * u;
+      var bx = p3.x + (p2.x - p3.x) * u, by = p3.y + (p2.y - p3.y) * u;
+      return { x: ax + (bx - ax) * v, y: ay + (by - ay) * v };
+    }
+    function windowGrid(p0, p1, p2, p3, cols, rows, f) {
+      var ws = 3.4 * S.scale;
+      for (var i = 1; i <= cols; i++) for (var j = 1; j <= rows; j++) {
+        var q = onQuad(p0, p1, p2, p3, i / (cols + 1), j / (rows + 1));
+        var lit = ((i * 7 + j * 3) % 4 !== 0);
+        ctx.fillStyle = 'rgba(10,14,26,0.85)'; ctx.fillRect(q.x - ws, q.y - ws, ws * 2, ws * 2);
+        ctx.fillStyle = lit ? 'rgba(255,232,150,' + (0.78 * f) + ')' : 'rgba(120,160,210,' + (0.4 * f) + ')';
+        ctx.fillRect(q.x - ws * 0.7, q.y - ws * 0.7, ws * 1.4, ws * 1.4);
+      }
+    }
+    function door(p0, p1, p2, p3, col) {
+      var b = onQuad(p0, p1, p2, p3, 0.5, 0.02), t = onQuad(p0, p1, p2, p3, 0.5, 0.22);
+      var w = 4 * S.scale;
+      ctx.fillStyle = shade(col, 0.5);
+      ctx.beginPath(); ctx.moveTo(b.x - w, b.y); ctx.lineTo(b.x + w, b.y); ctx.lineTo(t.x + w, t.y); ctx.lineTo(t.x - w, t.y); ctx.closePath(); ctx.fill();
+    }
+
+    function drawBuilding(b, now) {
+      var H = b.h * S.scale, kind = b.kind || 'block';
+      var c = corners(b, H);
+      // ground shadow
+      quad(c.bt, c.br, { x: c.bb.x + 7, y: c.bb.y + 7 }, c.bl, 'rgba(0,0,0,0.30)');
+      // walls
+      quad(c.bl, c.bb, c.tb, c.tl, shade(b.wall, 0.7));   // left
+      quad(c.br, c.bb, c.tb, c.tr, shade(b.wall, 1.0));   // right
+      var floors = Math.max(2, Math.round(b.h / 16));
+      windowGrid(c.bl, c.bb, c.tb, c.tl, Math.max(2, b.d), floors, 0.7);
+      windowGrid(c.br, c.bb, c.tb, c.tr, Math.max(2, b.w), floors, 1.0);
+      // subtle edge highlight
+      ctx.strokeStyle = shade(b.roof, 1.0); ctx.lineWidth = 1.2 * S.scale;
+      ctx.beginPath(); ctx.moveTo(c.bb.x, c.bb.y); ctx.lineTo(c.tb.x, c.tb.y); ctx.stroke();
+      // roof / crown
+      ctx.save(); ctx.shadowColor = b.roof; ctx.shadowBlur = 7 * S.scale;
+      if (kind === 'dome') {
+        var cx = (c.tt.x + c.tb.x) / 2, cy = (c.tt.y + c.tb.y) / 2;
+        var rw = Math.abs(c.tr.x - c.tl.x) / 2, rh = Math.abs(c.tb.y - c.tt.y) / 2 + 14 * S.scale;
+        quad(c.tt, c.tr, c.tb, c.tl, shade(b.roof, 0.85));
+        var g = ctx.createLinearGradient(cx, cy - rh, cx, cy); g.addColorStop(0, shade(b.roof, 1.3)); g.addColorStop(1, b.roof);
+        ctx.fillStyle = g; ctx.beginPath(); ctx.ellipse(cx, cy, rw, rh, 0, Math.PI, 2 * Math.PI); ctx.fill();
+      } else if (kind === 'tower') {
+        quad(c.tt, c.tr, c.tb, c.tl, b.roof);
+        // antenna + pulsing beacon
+        var apex = { x: (c.tt.x + c.tb.x) / 2, y: (c.tt.y + c.tb.y) / 2 };
+        ctx.strokeStyle = shade(b.roof, 1.2); ctx.lineWidth = 1.6 * S.scale;
+        ctx.beginPath(); ctx.moveTo(apex.x, apex.y); ctx.lineTo(apex.x, apex.y - 22 * S.scale); ctx.stroke();
+        var pulse = 0.5 + 0.5 * Math.sin(now / 350);
+        ctx.fillStyle = 'rgba(56,232,255,' + pulse + ')';
+        ctx.beginPath(); ctx.arc(apex.x, apex.y - 22 * S.scale, 3.2 * S.scale, 0, 7); ctx.fill();
+      } else if (kind === 'house') { // residential — pitched gable roof, no neon
+        ctx.shadowBlur = 0;
+        var rh = 13 * S.scale;
+        function upR(p) { return { x: p.x, y: p.y - rh }; }
+        var rA = upR({ x: (c.tt.x + c.tl.x) / 2, y: (c.tt.y + c.tl.y) / 2 });
+        var rB = upR({ x: (c.tr.x + c.tb.x) / 2, y: (c.tr.y + c.tb.y) / 2 });
+        quad(c.tt, c.tr, rB, rA, shade(b.roof, 1.05));   // sunlit slope
+        quad(c.tl, c.tb, rB, rA, shade(b.roof, 0.74));   // shaded slope
+        tri(c.tt, c.tl, rA, shade(b.wall, 1.08));        // gable end
+        tri(c.tr, c.tb, rB, shade(b.wall, 0.92));        // gable end
+        ctx.strokeStyle = shade(b.roof, 1.2); ctx.lineWidth = 1.4 * S.scale;
+        ctx.beginPath(); ctx.moveTo(rA.x, rA.y); ctx.lineTo(rB.x, rB.y); ctx.stroke(); // ridge
+      } else { // block — setback crown
+        quad(c.tt, c.tr, c.tb, c.tl, b.roof);
+        var inH = 16 * S.scale;
+        var sb = { gx: b.gx + b.w * 0.25, gy: b.gy + b.d * 0.25, w: b.w * 0.5, d: b.d * 0.5 };
+        var cc = corners(sb, H + inH);
+        // shift base of crown up to roof level
+        var lift = H;
+        function L(p) { return { x: p.x, y: p.y }; }
+        var cb = corners(sb, 0);
+        var ct = corners(sb, inH);
+        function up(p) { return { x: p.x, y: p.y - lift }; }
+        quad(up(cb.bl), up(cb.bb), up(ct.tb), up(ct.tl), shade(b.wall, 0.8));
+        quad(up(cb.br), up(cb.bb), up(ct.tb), up(ct.tr), shade(b.wall, 1.05));
+        quad(up(ct.tt), up(ct.tr), up(ct.tb), up(ct.tl), shade(b.roof, 1.1));
+      }
+      ctx.restore();
+      // ground-floor storefront only for shops/civic buildings — houses just get a door
+      if (kind === 'house') { door(c.br, c.bb, c.tb, c.tr, b.wall); houseSign(b, c); }
+      else drawStorefront(b, c);
+    }
+    function tri(a, b, d, fill) { ctx.fillStyle = fill; ctx.beginPath(); ctx.moveTo(a.x, a.y); ctx.lineTo(b.x, b.y); ctx.lineTo(d.x, d.y); ctx.closePath(); ctx.fill(); }
+    // small house number / family plate above the door (not a glowing holo sign)
+    function houseSign(b, c) {
+      if (!b.label) return;
+      var p = onQuad(c.br, c.bb, c.tb, c.tr, 0.5, 0.34);
+      ctx.font = '600 ' + (7 * S.scale) + 'px Rajdhani, sans-serif';
+      var tw = ctx.measureText(b.label).width + 8 * S.scale;
+      ctx.fillStyle = 'rgba(18,14,10,0.8)'; rr(p.x - tw / 2, p.y - 6 * S.scale, tw, 11 * S.scale, 2 * S.scale); ctx.fill();
+      ctx.fillStyle = '#e8dcc0'; ctx.textAlign = 'center'; ctx.textBaseline = 'middle'; ctx.fillText(b.label, p.x, p.y);
+    }
+
+    // street-level retail on the most-visible (right) wall: p0=br p1=bb p2=tb p3=tr
+    function drawStorefront(b, c) {
+      var p0 = c.br, p1 = c.bb, p2 = c.tb, p3 = c.tr, accent = b.roof;
+      // big glowing shop windows along the ground floor
+      var cols = Math.max(2, Math.round(b.w * 1.6));
+      for (var i = 1; i <= cols; i++) {
+        var wt = onQuad(p0, p1, p2, p3, i / (cols + 1), 0.175), wb = onQuad(p0, p1, p2, p3, i / (cols + 1), 0.03);
+        var ww = 5 * S.scale, wh = wb.y - wt.y;
+        ctx.fillStyle = 'rgba(6,10,20,0.92)'; ctx.fillRect(wt.x - ww, wt.y, ww * 2, wh);
+        ctx.fillStyle = 'rgba(255,222,158,0.92)'; ctx.fillRect(wt.x - ww * 0.78, wt.y + 1.2 * S.scale, ww * 1.56, wh - 2.4 * S.scale);
+        ctx.fillStyle = 'rgba(255,255,255,0.18)'; ctx.fillRect(wt.x - ww * 0.78, wt.y + 1.2 * S.scale, ww * 0.5, wh - 2.4 * S.scale);
+      }
+      door(p0, p1, p2, p3, b.wall);
+      // awning: a coloured strip that juts toward the street with a scalloped valance
+      var al = onQuad(p0, p1, p2, p3, 0.05, 0.205), ar = onQuad(p0, p1, p2, p3, 0.95, 0.205), jut = 9 * S.scale, seg = 8;
+      function lerp(t) { return { x: al.x + (ar.x - al.x) * t, y: al.y + (ar.y - al.y) * t }; }
+      for (var k = 0; k < seg; k++) {
+        var a0 = lerp(k / seg), a1 = lerp((k + 1) / seg);
+        ctx.fillStyle = (k % 2) ? shade(accent, 1.25) : shade(accent, 0.92);
+        ctx.beginPath(); ctx.moveTo(a0.x, a0.y); ctx.lineTo(a1.x, a1.y); ctx.lineTo(a1.x, a1.y + jut); ctx.lineTo(a0.x, a0.y + jut); ctx.closePath(); ctx.fill();
+        ctx.fillStyle = shade(accent, 0.78);
+        ctx.beginPath(); ctx.moveTo(a0.x, a0.y + jut); ctx.lineTo(a1.x, a1.y + jut); ctx.lineTo((a0.x + a1.x) / 2, (a0.y + a1.y) / 2 + jut + 4 * S.scale); ctx.closePath(); ctx.fill();
+      }
+      // shop sign mounted on the façade above the awning (replaces the old floating word)
+      if (b.label) {
+        var sc = onQuad(p0, p1, p2, p3, 0.5, 0.40);
+        ctx.font = '700 ' + (8.5 * S.scale) + 'px Orbitron, sans-serif';
+        var tw = ctx.measureText(b.label).width + 12 * S.scale, th = 14 * S.scale;
+        ctx.fillStyle = 'rgba(6,10,20,0.94)'; rr(sc.x - tw / 2, sc.y - th / 2, tw, th, 3 * S.scale); ctx.fill();
+        ctx.strokeStyle = shade(accent, 1.2); ctx.lineWidth = 1.3 * S.scale; ctx.stroke();
+        ctx.save(); ctx.shadowColor = accent; ctx.shadowBlur = 6 * S.scale;
+        ctx.fillStyle = shade(accent, 1.3); ctx.textAlign = 'center'; ctx.textBaseline = 'middle'; ctx.fillText(b.label, sc.x, sc.y);
+        ctx.restore();
+      }
+    }
+
+    // ---------- props ----------
+    function drawProp(p, now) {
+      if (p.type === 'fountain') {
+        var c = iso(p.gx, p.gy);
+        ctx.fillStyle = 'rgba(40,60,90,0.9)'; ctx.beginPath(); ctx.ellipse(c.x, c.y, 22 * S.scale, 11 * S.scale, 0, 0, 7); ctx.fill();
+        ctx.fillStyle = '#2bc7ff'; ctx.beginPath(); ctx.ellipse(c.x, c.y, 18 * S.scale, 8 * S.scale, 0, 0, 7); ctx.fill();
+        for (var k = 0; k < 3; k++) {
+          var t = (now / 700 + k / 3) % 1, rr2 = 4 + t * 14;
+          ctx.strokeStyle = 'rgba(160,235,255,' + (0.6 * (1 - t)) + ')'; ctx.lineWidth = 1.4 * S.scale;
+          ctx.beginPath(); ctx.ellipse(c.x, c.y, rr2 * S.scale, rr2 * 0.5 * S.scale, 0, 0, 7); ctx.stroke();
+        }
+        ctx.strokeStyle = 'rgba(180,240,255,0.8)'; ctx.lineWidth = 2 * S.scale;
+        ctx.beginPath(); ctx.moveTo(c.x, c.y - 4 * S.scale); ctx.lineTo(c.x, c.y - 16 * S.scale); ctx.stroke();
+      } else if (p.type === 'pond') {
+        var a = iso(p.gx, p.gy), b = iso(p.gx + (p.w || 2), p.gy), d = iso(p.gx + (p.w || 2), p.gy + (p.d || 2)), e = iso(p.gx, p.gy + (p.d || 2));
+        var g = ctx.createLinearGradient(a.x, a.y, d.x, d.y); g.addColorStop(0, '#1f6fa8'); g.addColorStop(1, '#0e4a78');
+        ctx.fillStyle = g; ctx.beginPath(); ctx.moveTo(a.x, a.y); ctx.lineTo(b.x, b.y); ctx.lineTo(d.x, d.y); ctx.lineTo(e.x, e.y); ctx.closePath(); ctx.fill();
+        ctx.strokeStyle = 'rgba(160,220,255,0.4)'; ctx.lineWidth = 1; ctx.stroke();
+      } else if (p.type === 'bench') {
+        var c2 = iso(p.gx + 0.5, p.gy + 0.5);
+        ctx.fillStyle = '#6a4a2e'; ctx.fillRect(c2.x - 8 * S.scale, c2.y - 4 * S.scale, 16 * S.scale, 4 * S.scale);
+      } else if (p.type === 'lamp') {
+        var c3 = iso(p.gx + 0.5, p.gy + 0.5);
+        ctx.strokeStyle = '#556'; ctx.lineWidth = 2 * S.scale; ctx.beginPath(); ctx.moveTo(c3.x, c3.y); ctx.lineTo(c3.x, c3.y - 22 * S.scale); ctx.stroke();
+        var rg = ctx.createRadialGradient(c3.x, c3.y - 22 * S.scale, 1, c3.x, c3.y - 22 * S.scale, 12 * S.scale);
+        rg.addColorStop(0, 'rgba(255,235,150,0.9)'); rg.addColorStop(1, 'rgba(255,235,150,0)');
+        ctx.fillStyle = rg; ctx.beginPath(); ctx.arc(c3.x, c3.y - 22 * S.scale, 12 * S.scale, 0, 7); ctx.fill();
+      } else if (p.type === 'patio') {
+        var c4 = iso(p.gx + 0.5, p.gy + 0.5);
+        ctx.fillStyle = '#d65b5b'; ctx.beginPath(); ctx.moveTo(c4.x, c4.y - 16 * S.scale); ctx.lineTo(c4.x - 11 * S.scale, c4.y - 7 * S.scale); ctx.lineTo(c4.x + 11 * S.scale, c4.y - 7 * S.scale); ctx.closePath(); ctx.fill();
+        ctx.strokeStyle = '#888'; ctx.lineWidth = 1.5 * S.scale; ctx.beginPath(); ctx.moveTo(c4.x, c4.y - 7 * S.scale); ctx.lineTo(c4.x, c4.y); ctx.stroke();
+      } else if (p.type === 'table') {       // café table with chairs + parasol
+        var ct = iso(p.gx + 0.5, p.gy + 0.5), s = S.scale;
+        [[-9, 1], [9, 1], [0, -5], [0, 6]].forEach(function (o) {
+          ctx.fillStyle = '#39425a'; ctx.beginPath(); ctx.ellipse(ct.x + o[0] * s, ct.y + o[1] * s * 0.6, 2.8 * s, 1.6 * s, 0, 0, 7); ctx.fill();
+          ctx.fillStyle = '#2a3146'; ctx.fillRect(ct.x + o[0] * s - 2.4 * s, ct.y + o[1] * s * 0.6 - 5 * s, 4.8 * s, 5 * s);
+        });
+        ctx.fillStyle = 'rgba(0,0,0,0.25)'; ctx.beginPath(); ctx.ellipse(ct.x, ct.y + 2 * s, 8 * s, 3.5 * s, 0, 0, 7); ctx.fill();
+        ctx.strokeStyle = '#7a8398'; ctx.lineWidth = 1.6 * s; ctx.beginPath(); ctx.moveTo(ct.x, ct.y - 1 * s); ctx.lineTo(ct.x, ct.y + 3 * s); ctx.stroke();
+        ctx.fillStyle = '#cdd6ea'; ctx.beginPath(); ctx.ellipse(ct.x, ct.y - 3 * s, 7 * s, 3.2 * s, 0, 0, 7); ctx.fill();
+        ctx.strokeStyle = '#8a93a8'; ctx.lineWidth = 1.4 * s; ctx.beginPath(); ctx.moveTo(ct.x, ct.y - 4 * s); ctx.lineTo(ct.x, ct.y - 17 * s); ctx.stroke();
+        ctx.fillStyle = '#d65b5b'; ctx.beginPath(); ctx.moveTo(ct.x, ct.y - 22 * s); ctx.lineTo(ct.x - 11 * s, ct.y - 15 * s); ctx.lineTo(ct.x + 11 * s, ct.y - 15 * s); ctx.closePath(); ctx.fill();
+        ctx.fillStyle = '#b94a4a'; for (var pz = 0; pz < 3; pz += 2) { ctx.beginPath(); ctx.moveTo(ct.x - 11 * s + pz * 7.3 * s, ct.y - 15 * s); ctx.lineTo(ct.x - 3.7 * s + pz * 7.3 * s, ct.y - 15 * s); ctx.lineTo(ct.x - 7.3 * s + pz * 7.3 * s, ct.y - 18.5 * s); ctx.closePath(); ctx.fill(); }
+      } else if (p.type === 'stall') {       // market stall: counter, goods, striped canopy
+        var cs = iso(p.gx + 0.5, p.gy + 0.5), s2 = S.scale, col = p.color || '#caa23f';
+        ctx.fillStyle = 'rgba(0,0,0,0.25)'; ctx.beginPath(); ctx.ellipse(cs.x, cs.y + 2 * s2, 15 * s2, 4 * s2, 0, 0, 7); ctx.fill();
+        ctx.fillStyle = '#5a4632'; ctx.fillRect(cs.x - 13 * s2, cs.y - 6 * s2, 26 * s2, 8 * s2);
+        ctx.fillStyle = '#48372a'; ctx.fillRect(cs.x - 13 * s2, cs.y - 6 * s2, 26 * s2, 2 * s2);
+        ['#e5663e', '#e0b53f', '#5aa86a', '#d6543f'].forEach(function (gc, gi) { ctx.fillStyle = gc; ctx.beginPath(); ctx.arc(cs.x - 9 * s2 + gi * 6 * s2, cs.y - 7 * s2, 2.6 * s2, 0, 7); ctx.fill(); });
+        ctx.strokeStyle = '#6a5a48'; ctx.lineWidth = 1.8 * s2; ctx.beginPath();
+        ctx.moveTo(cs.x - 13 * s2, cs.y - 6 * s2); ctx.lineTo(cs.x - 13 * s2, cs.y - 22 * s2);
+        ctx.moveTo(cs.x + 13 * s2, cs.y - 6 * s2); ctx.lineTo(cs.x + 13 * s2, cs.y - 22 * s2); ctx.stroke();
+        for (var q = 0; q < 7; q++) { ctx.fillStyle = (q % 2) ? col : shade(col, 1.28); ctx.fillRect(cs.x - 13 * s2 + q * (26 / 7) * s2, cs.y - 25 * s2, (26 / 7) * s2 + 0.5, 5 * s2); }
+        ctx.fillStyle = shade(col, 0.85); for (var v = 0; v < 7; v++) { var vx = cs.x - 13 * s2 + (v + 0.5) * (26 / 7) * s2; ctx.beginPath(); ctx.moveTo(vx - (13 / 7) * s2, cs.y - 20 * s2); ctx.lineTo(vx + (13 / 7) * s2, cs.y - 20 * s2); ctx.lineTo(vx, cs.y - 17 * s2); ctx.closePath(); ctx.fill(); }
+      } else if (p.type === 'planter') {     // raised flower bed
+        var cp = iso(p.gx + 0.5, p.gy + 0.5), s3 = S.scale;
+        ctx.fillStyle = '#5a4632'; ctx.fillRect(cp.x - 8 * s3, cp.y - 3 * s3, 16 * s3, 5 * s3);
+        ctx.fillStyle = '#48372a'; ctx.fillRect(cp.x - 8 * s3, cp.y - 3 * s3, 16 * s3, 1.6 * s3);
+        var fc = ['#f06ea0', '#ffd76a', '#7CFFB2', '#d65b5b'];
+        for (var f = 0; f < 5; f++) { ctx.fillStyle = '#2f8f55'; ctx.fillRect(cp.x - 6 * s3 + f * 3 * s3, cp.y - 7 * s3, 1.4 * s3, 4 * s3); ctx.fillStyle = fc[f % fc.length]; ctx.beginPath(); ctx.arc(cp.x - 5.3 * s3 + f * 3 * s3, cp.y - 8 * s3, 1.8 * s3, 0, 7); ctx.fill(); }
+      }
+    }
+
+    function drawTree(t) {
+      var p = iso(t[0] + 0.5, t[1] + 0.5);
+      ctx.fillStyle = 'rgba(0,0,0,0.22)'; ctx.beginPath(); ctx.ellipse(p.x, p.y, 10 * S.scale, 5 * S.scale, 0, 0, 7); ctx.fill();
+      ctx.fillStyle = '#4a2e1a'; ctx.fillRect(p.x - 2 * S.scale, p.y - 13 * S.scale, 4 * S.scale, 13 * S.scale);
+      var g = ctx.createRadialGradient(p.x - 4 * S.scale, p.y - 22 * S.scale, 2, p.x, p.y - 18 * S.scale, 15 * S.scale);
+      g.addColorStop(0, '#5fe0a0'); g.addColorStop(1, '#1c7a4a'); ctx.fillStyle = g;
+      ctx.beginPath(); ctx.arc(p.x, p.y - 18 * S.scale, 12 * S.scale, 0, 7); ctx.fill();
+    }
+
+    // ---------- sprite primitives ----------
+    // a little walking person; returns head-top y for bubble/mood anchoring
+    function person(x, y, sc, shirt, hair, ph, moving) {
+      var s = S.scale * sc;
+      ctx.fillStyle = 'rgba(0,0,0,0.28)'; ctx.beginPath(); ctx.ellipse(x, y, 7 * s, 2.8 * s, 0, 0, 7); ctx.fill();
+      var sw = moving ? Math.sin(ph) * 3 * s : 0.6 * s;
+      var lift = moving ? Math.abs(Math.cos(ph)) * 1.1 * s : 0;
+      ctx.lineCap = 'round';
+      // legs
+      ctx.strokeStyle = '#34384e'; ctx.lineWidth = 2.6 * s;
+      ctx.beginPath(); ctx.moveTo(x, y - 8 * s); ctx.lineTo(x - 2.4 * s + sw, y); ctx.stroke();
+      ctx.beginPath(); ctx.moveTo(x, y - 8 * s); ctx.lineTo(x + 2.4 * s - sw, y); ctx.stroke();
+      var ty = y - 8 * s - lift;
+      // arms (behind torso)
+      ctx.strokeStyle = shade(shirt, 0.82); ctx.lineWidth = 2.3 * s;
+      ctx.beginPath(); ctx.moveTo(x - 3.5 * s, ty - 8 * s); ctx.lineTo(x - 6 * s - sw * 0.5, ty - 1.5 * s); ctx.stroke();
+      ctx.beginPath(); ctx.moveTo(x + 3.5 * s, ty - 8 * s); ctx.lineTo(x + 6 * s + sw * 0.5, ty - 1.5 * s); ctx.stroke();
+      // torso
+      ctx.fillStyle = shirt; rr(x - 4.6 * s, ty - 12 * s, 9.2 * s, 13 * s, 3 * s); ctx.fill();
+      // head
+      var hcy = ty - 16 * s;
+      ctx.fillStyle = '#e7b893'; ctx.beginPath(); ctx.arc(x, hcy, 4.6 * s, 0, 7); ctx.fill();
+      ctx.fillStyle = hair; ctx.beginPath(); ctx.arc(x, hcy - 1.4 * s, 4.7 * s, Math.PI, 2 * Math.PI); ctx.fill();
+      return hcy - 5 * s;
+    }
+    function dog(x, y, sc, ph, moving) {
+      var s = S.scale * sc, wag = moving ? Math.sin(ph * 1.4) * 2 * s : 0;
+      ctx.fillStyle = 'rgba(0,0,0,0.26)'; ctx.beginPath(); ctx.ellipse(x, y, 8 * s, 3 * s, 0, 0, 7); ctx.fill();
+      ctx.fillStyle = '#8a6a45'; rr(x - 7 * s, y - 8 * s, 12 * s, 6 * s, 3 * s); ctx.fill(); // body
+      ctx.strokeStyle = '#6a4f33'; ctx.lineWidth = 1.8 * s; // legs
+      ctx.beginPath(); ctx.moveTo(x - 5 * s, y - 3 * s); ctx.lineTo(x - 5 * s, y); ctx.moveTo(x + 3 * s, y - 3 * s); ctx.lineTo(x + 3 * s, y); ctx.stroke();
+      ctx.fillStyle = '#8a6a45'; ctx.beginPath(); ctx.arc(x + 6 * s, y - 9 * s, 3.4 * s, 0, 7); ctx.fill(); // head
+      ctx.strokeStyle = '#8a6a45'; ctx.lineWidth = 2 * s; ctx.beginPath(); ctx.moveTo(x - 7 * s, y - 7 * s); ctx.lineTo(x - 10 * s - wag, y - 9 * s); ctx.stroke(); // tail
+    }
+    function wheel(x, y, r, ph) {
+      ctx.strokeStyle = '#1a1d28'; ctx.lineWidth = 2.2 * S.scale; ctx.beginPath(); ctx.arc(x, y, r, 0, 7); ctx.stroke();
+      ctx.strokeStyle = 'rgba(200,210,230,0.5)'; ctx.lineWidth = 1 * S.scale;
+      for (var a = 0; a < 3; a++) { var an = ph + a * 2.1; ctx.beginPath(); ctx.moveTo(x, y); ctx.lineTo(x + Math.cos(an) * r, y + Math.sin(an) * r); ctx.stroke(); }
+    }
+    function bike(x, y, ph, moving, shirt) {
+      var s = S.scale;
+      ctx.fillStyle = 'rgba(0,0,0,0.28)'; ctx.beginPath(); ctx.ellipse(x, y, 12 * s, 3 * s, 0, 0, 7); ctx.fill();
+      var spin = moving ? ph * 2 : 0;
+      wheel(x - 7 * s, y - 4 * s, 4.6 * s, spin); wheel(x + 7 * s, y - 4 * s, 4.6 * s, spin);
+      ctx.strokeStyle = '#cfd6ea'; ctx.lineWidth = 1.8 * s; // frame
+      ctx.beginPath(); ctx.moveTo(x - 7 * s, y - 4 * s); ctx.lineTo(x, y - 4 * s); ctx.lineTo(x + 7 * s, y - 4 * s); ctx.moveTo(x, y - 4 * s); ctx.lineTo(x + 2 * s, y - 12 * s); ctx.stroke();
+      // rider
+      var rsw = moving ? Math.sin(ph) * 2 * s : 0;
+      ctx.fillStyle = shirt; rr(x - 2.5 * s, y - 19 * s, 7 * s, 9 * s, 2.5 * s); ctx.fill();
+      ctx.fillStyle = '#e7b893'; ctx.beginPath(); ctx.arc(x + 1 * s, y - 21 * s, 3.6 * s, 0, 7); ctx.fill();
+      ctx.strokeStyle = shade(shirt, 0.8); ctx.lineWidth = 1.8 * s;
+      ctx.beginPath(); ctx.moveTo(x + 1 * s, y - 15 * s); ctx.lineTo(x + 7 * s, y - 8 * s); ctx.stroke(); // arm to bars
+      ctx.beginPath(); ctx.moveTo(x + 1 * s, y - 11 * s); ctx.lineTo(x - 1 * s + rsw, y - 4 * s); ctx.stroke(); // leg pedaling
+      return y - 26 * s;
+    }
+
+    // ---------- ambient crowd ----------
+    function stepAmbient(a, dt) {
+      if (a.follow >= 0 && S.chars[a.follow]) { var f = S.chars[a.follow]; a.tx = f.x + 0.7; a.ty = f.y + 0.7; }
+      var dx = a.tx - a.x, dy = a.ty - a.y, d = Math.hypot(dx, dy);
+      if (d > 0.05) {
+        var sp = a.sp * Math.min(1, d / 1.0);
+        a.vx += ((dx / d) * sp - a.vx) * Math.min(1, dt * 4);
+        a.vy += ((dy / d) * sp - a.vy) * Math.min(1, dt * 4);
+        var nx = a.x + a.vx * dt, ny = a.y + a.vy * dt;
+        if (walkable(nx, a.y)) a.x = nx; else { a.vx = 0; a.tx = a.x; }
+        if (walkable(a.x, ny)) a.y = ny; else { a.vy = 0; a.ty = a.y; }
+        a.ph += dt * 6;
+      } else if (a.follow < 0) {
+        a.idle -= dt;
+        if (a.idle <= 0) { var t = randWalkable(); a.tx = t[0]; a.ty = t[1]; a.idle = 2.5 + Math.random() * 5; }
+      }
+    }
+    function drawAmbient(a) {
+      var p = iso(a.x + 0.5, a.y + 0.5), mv = Math.hypot(a.vx, a.vy) > 0.08;
+      if (a.type === 'dog') dog(p.x, p.y, a.sc, a.ph, mv);
+      else if (a.type === 'bike') bike(p.x, p.y, a.ph, mv, a.shirt);
+      else person(p.x, p.y, a.sc, a.shirt, a.hair, a.ph, mv);
+    }
+    function stepCar(c, dt) {
+      var max = (c.axis === 'h') ? S.W.cols : S.W.rows; c.pos += c.dir * c.sp * dt;
+      if (c.pos < 0) { c.pos = 0; c.dir = 1; } if (c.pos > max) { c.pos = max; c.dir = -1; }
+    }
+    function drawCar(c) {
+      var gx = (c.axis === 'h') ? c.pos : c.line + 0.5, gy = (c.axis === 'h') ? c.line + 0.5 : c.pos, p = iso(gx, gy);
+      var s = S.scale, fwd = c.dir > 0 ? 1 : -1;
+      ctx.fillStyle = 'rgba(0,0,0,0.32)'; ctx.beginPath(); ctx.ellipse(p.x, p.y, 13 * s, 4.5 * s, 0, 0, 7); ctx.fill();
+      // wheels
+      ctx.fillStyle = '#15171f'; ctx.beginPath(); ctx.arc(p.x - 7 * s, p.y - 2 * s, 2.6 * s, 0, 7); ctx.arc(p.x + 7 * s, p.y - 2 * s, 2.6 * s, 0, 7); ctx.fill();
+      // body
+      var g = ctx.createLinearGradient(p.x, p.y - 13 * s, p.x, p.y - 2 * s); g.addColorStop(0, shade(c.color, 1.15)); g.addColorStop(1, c.color);
+      ctx.fillStyle = g; rr(p.x - 11 * s, p.y - 9 * s, 22 * s, 8 * s, 3 * s); ctx.fill();
+      // cabin
+      ctx.fillStyle = shade(c.color, 1.05); rr(p.x - 5 * s, p.y - 14 * s, 11 * s, 6 * s, 2.5 * s); ctx.fill();
+      ctx.fillStyle = 'rgba(180,225,255,0.9)'; rr(p.x - 3.5 * s, p.y - 13 * s, 8 * s, 4 * s, 1.5 * s); ctx.fill();
+      // lights
+      ctx.fillStyle = 'rgba(255,240,180,0.95)'; ctx.beginPath(); ctx.arc(p.x + 10 * s * fwd, p.y - 6 * s, 1.6 * s, 0, 7); ctx.fill();
+      ctx.fillStyle = 'rgba(255,90,90,0.9)'; ctx.beginPath(); ctx.arc(p.x - 10 * s * fwd, p.y - 6 * s, 1.4 * s, 0, 7); ctx.fill();
+    }
+
+    // ---------- characters ----------
+    function drawChar(c, now) {
+      var p = iso(c.x + 0.5, c.y + 0.5);
+      var moving = Math.hypot(c.vx, c.vy) > 0.08;
+      if (c.speaking) {
+        var pr = 1 + Math.sin(now / 220) * 0.12;
+        ctx.strokeStyle = 'rgba(56,232,255,0.9)'; ctx.lineWidth = 2.4 * S.scale;
+        ctx.beginPath(); ctx.ellipse(p.x, p.y, 13 * S.scale * pr, 5.5 * S.scale * pr, 0, 0, 7); ctx.stroke();
+      }
+      var hy = (c.vehicle === 'bike') ? bike(p.x, p.y, c.bob, moving, c.color)
+                                      : person(p.x, p.y, 1.35, c.color, '#241c14', c.bob, moving);
+      if (c.moodEmoji) { ctx.font = (12 * S.scale) + 'px serif'; ctx.textAlign = 'center'; ctx.textBaseline = 'middle'; ctx.fillText(c.moodEmoji, p.x + 9 * S.scale, hy + 3 * S.scale); }
+      var label = c.short + (c.activity ? '  ' + c.activity : '');
+      ctx.font = '600 ' + (9.5 * S.scale) + 'px Rajdhani, sans-serif'; ctx.textAlign = 'center'; ctx.textBaseline = 'middle';
+      var nw = ctx.measureText(label).width + 12 * S.scale;
+      ctx.fillStyle = 'rgba(8,12,24,0.8)'; rr(p.x - nw / 2, p.y + 3 * S.scale, nw, 13 * S.scale, 5 * S.scale); ctx.fill();
+      ctx.strokeStyle = c.color; ctx.lineWidth = 1; ctx.stroke();
+      ctx.fillStyle = '#eaf0ff'; ctx.fillText(label, p.x, p.y + 9.5 * S.scale);
+      if (c.bubble) drawBubble(c, p.x, hy, now);
+    }
+    function drawBubble(c, x, topY, now) {
+      var shown = Math.min(c.bubble.length, Math.floor((now - c.bubbleAt) / 22));
+      var s = c.bubble.slice(0, shown) || ' ';
+      ctx.font = '600 ' + (12 * S.scale) + 'px Rajdhani, sans-serif';
+      var maxW = 180 * S.scale, lines = wrap(s, maxW), lh = 15 * S.scale, pad = 8 * S.scale;
+      var bw = 0; lines.forEach(function (l) { bw = Math.max(bw, ctx.measureText(l).width); });
+      bw += pad * 2; var bh = lines.length * lh + pad * 2;
+      var bx = x - bw / 2, by = topY - 14 * S.scale - bh;
+      ctx.fillStyle = 'rgba(12,18,34,0.93)'; rr(bx, by, bw, bh, 8 * S.scale); ctx.fill();
+      ctx.strokeStyle = 'rgba(120,200,255,0.4)'; ctx.lineWidth = 1; ctx.stroke();
+      ctx.fillStyle = 'rgba(12,18,34,0.93)'; ctx.beginPath(); ctx.moveTo(x - 6 * S.scale, by + bh); ctx.lineTo(x + 6 * S.scale, by + bh); ctx.lineTo(x, by + bh + 8 * S.scale); ctx.closePath(); ctx.fill();
+      ctx.fillStyle = '#eaf0ff'; ctx.textAlign = 'left'; ctx.textBaseline = 'top';
+      lines.forEach(function (l, i) { ctx.fillText(l, bx + pad, by + pad + i * lh); });
+      ctx.textAlign = 'center';
+    }
+    function wrap(s, maxW) {
+      var w = s.split(' '), out = [], cur = '';
+      for (var i = 0; i < w.length; i++) { var t = cur ? cur + ' ' + w[i] : w[i]; if (ctx.measureText(t).width > maxW && cur) { out.push(cur); cur = w[i]; } else cur = t; }
+      if (cur) out.push(cur); return out.slice(0, 4);
+    }
+    function rr(x, y, w, h, r) { ctx.beginPath(); ctx.moveTo(x + r, y); ctx.arcTo(x + w, y, x + w, y + h, r); ctx.arcTo(x + w, y + h, x, y + h, r); ctx.arcTo(x, y + h, x, y, r); ctx.arcTo(x, y, x + w, y, r); ctx.closePath(); }
+
+    // ---------- physics ----------
+    function step(c, dt, now) {
+      var dx = c.tx - c.x, dy = c.ty - c.y, dist = Math.hypot(dx, dy);
+      if (dist > 0.04) {
+        var maxV = (c.vehicle === 'bike') ? 1.9 : (c.running ? 1.3 : 0.85), arrive = 1.1;
+        var sp = maxV * Math.min(1, dist / arrive);
+        c.vx += ((dx / dist) * sp - c.vx) * Math.min(1, dt * 5);
+        c.vy += ((dy / dist) * sp - c.vy) * Math.min(1, dt * 5);
+        // resolve per-axis so people slide along walls and never walk into buildings or the pool
+        var nx = c.x + c.vx * dt, ny = c.y + c.vy * dt;
+        if (walkable(nx, c.y)) c.x = nx; else c.vx = 0;
+        if (walkable(c.x, ny)) c.y = ny; else c.vy = 0;
+        c.bob += dt * 6;
+      } else { c.x = c.tx; c.y = c.ty; c.vx *= 0.8; c.vy *= 0.8; }
+      if (c.speaking && now - c.bubbleAt > 7500) { c.speaking = false; c.bubble = null; c.returnAt = now + 800; }
+      if (!c.speaking && c.returnAt && now > c.returnAt) { c.tx = c.home[0]; c.ty = c.home[1]; c.returnAt = 0; c.activity = ''; c.vehicle = ''; c.running = false; }
+      if (!c.speaking && !c.returnAt) {
+        c.idle -= dt;
+        if (c.idle <= 0 && Math.hypot(c.tx - c.x, c.ty - c.y) < 0.1) {
+          // a calm town: mostly stand and watch, sometimes rest at a seat, rarely amble a short way
+          var roll = Math.random();
+          if (roll < 0.5) {                                   // linger where they are
+            c.idle = 5 + Math.random() * 7;
+          } else if (roll < 0.78 && S.seats && S.seats.length) { // go sit down for a while
+            var st = S.seats[Math.floor(Math.random() * S.seats.length)];
+            if (walkable(st[0], st[1])) { c.tx = st[0]; c.ty = st[1]; }
+            c.idle = 7 + Math.random() * 6;
+          } else {                                            // gentle amble to a nearby tile
+            for (var k = 0; k < 8; k++) { var ax = Math.round(c.x + (Math.random() * 4 - 2)), ay = Math.round(c.y + (Math.random() * 4 - 2)); if (walkable(ax, ay)) { c.tx = ax; c.ty = ay; break; } }
+            c.idle = 4 + Math.random() * 5;
+          }
+          c.running = false;   // never run while idle — only when actually reacting to an event
+        }
+      }
+    }
+
+    // ---------- crisis overlay ----------
+    function drawCrisis(now, rect) {
+      var cr = S.crisis;
+      if (!cr || !cr.active) return;
+      var t = now / 1000, s = S.scale;
+      var has = cr.tile && S.W;
+      var c = has ? iso(cr.tile[0] + 0.5, cr.tile[1] + 0.5) : { x: rect.width / 2, y: rect.height / 2 };
+      var kind = cr.kind || 'fire';
+
+      if (has && kind === 'fire') {
+        var glow = ctx.createRadialGradient(c.x, c.y, 0, c.x, c.y, 64 * s);
+        glow.addColorStop(0, 'rgba(255,150,50,0.5)'); glow.addColorStop(1, 'rgba(255,80,0,0)');
+        ctx.fillStyle = glow; ctx.beginPath(); ctx.ellipse(c.x, c.y, 64 * s, 32 * s, 0, 0, 7); ctx.fill();
+        for (var i = 0; i < 5; i++) {
+          var fx = c.x + Math.sin(t * 4 + i) * 6 * s, base = c.y - 2 * s, h = (18 + Math.sin(t * 9 + i * 2) * 7) * s;
+          var fg = ctx.createLinearGradient(fx, base, fx, base - h);
+          fg.addColorStop(0, 'rgba(255,210,80,0.95)'); fg.addColorStop(0.6, 'rgba(255,110,20,0.85)'); fg.addColorStop(1, 'rgba(200,40,0,0)');
+          ctx.fillStyle = fg; ctx.beginPath(); ctx.moveTo(fx - 5 * s, base);
+          ctx.quadraticCurveTo(fx - 3 * s, base - h * 0.6, fx, base - h);
+          ctx.quadraticCurveTo(fx + 3 * s, base - h * 0.6, fx + 5 * s, base); ctx.closePath(); ctx.fill();
+        }
+        for (var k = 0; k < 4; k++) {
+          var pt = (t * 0.5 + k * 0.25) % 1, sx = c.x + Math.sin(t + k) * 10 * s, sy = c.y - 20 * s - pt * 40 * s;
+          ctx.fillStyle = 'rgba(70,70,80,' + (0.35 * (1 - pt)) + ')';
+          ctx.beginPath(); ctx.arc(sx, sy, (6 + pt * 10) * s, 0, 7); ctx.fill();
+        }
+      } else if (has && kind === 'storm') {
+        ctx.fillStyle = 'rgba(20,30,60,0.22)'; ctx.fillRect(0, 0, rect.width, rect.height);
+        ctx.strokeStyle = 'rgba(150,200,255,0.5)'; ctx.lineWidth = 1 * s;
+        for (var r = 0; r < 40; r++) {
+          var rx = c.x + (Math.random() * 120 - 60) * s, ry = c.y + (Math.random() * 80 - 60) * s;
+          ctx.beginPath(); ctx.moveTo(rx, ry); ctx.lineTo(rx - 2 * s, ry + 8 * s); ctx.stroke();
+        }
+      } else if (kind === 'blackout') {
+        var fl = 0.5 + Math.sin(t * 18) * 0.06;
+        var v = ctx.createRadialGradient(c.x, c.y, 24 * s, c.x, c.y, Math.max(rect.width, rect.height) * 0.8);
+        v.addColorStop(0, 'rgba(0,0,12,0.08)'); v.addColorStop(1, 'rgba(0,0,12,' + fl + ')');
+        ctx.fillStyle = v; ctx.fillRect(0, 0, rect.width, rect.height);
+      } else if (has && kind === 'search') {
+        var pr = (t % 1.2) / 1.2;
+        ctx.strokeStyle = 'rgba(120,220,255,' + (0.7 * (1 - pr)) + ')'; ctx.lineWidth = 2 * s;
+        ctx.beginPath(); ctx.ellipse(c.x, c.y, (10 + pr * 42) * s, (5 + pr * 21) * s, 0, 0, 7); ctx.stroke();
+      }
+
+      if (cr.chaos > 0.01) {
+        var cx = rect.width / 2, cy = rect.height / 2;
+        var cv = ctx.createRadialGradient(cx, cy, rect.height * 0.3, cx, cy, rect.height * 0.78);
+        cv.addColorStop(0, 'rgba(255,40,20,0)'); cv.addColorStop(1, 'rgba(255,30,10,' + (0.38 * cr.chaos) + ')');
+        ctx.fillStyle = cv; ctx.fillRect(0, 0, rect.width, rect.height);
+      }
+    }
+
+    // ---------- loop ----------
+    var last = performance.now();
+    function frame(now) {
+      var dt = Math.min(0.05, (now - last) / 1000); last = now;
+      var rect = canvas.getBoundingClientRect();
+      ctx.setTransform(DPR, 0, 0, DPR, 0, 0);
+      var sky = ctx.createLinearGradient(0, 0, 0, rect.height);
+      sky.addColorStop(0, '#161038'); sky.addColorStop(0.45, '#2a1c52'); sky.addColorStop(1, '#0b1e16');
+      ctx.fillStyle = sky; ctx.fillRect(0, 0, rect.width, rect.height);
+      if (!S.W) { requestAnimationFrame(frame); return; }
+      for (var s = 0; s <= (S.W.cols + S.W.rows); s++) for (var gx = 0; gx < S.W.cols; gx++) { var gy = s - gx; if (gy < 0 || gy >= S.W.rows) continue; drawTile(gx, gy); }
+      S.chars.forEach(function (c) { step(c, dt, now); });
+      (S.amb || []).forEach(function (a) { stepAmbient(a, dt); });
+      (S.cars || []).forEach(function (c) { stepCar(c, dt); });
+      var ents = [];
+      (S.W.props || []).forEach(function (p) { var k = (p.gy + (p.d || 1)) + (p.gx + (p.w || 1)); ents.push({ d: k - 0.6, f: function () { drawProp(p, now); } }); });
+      S.W.buildings.forEach(function (b) { ents.push({ d: (b.gx + b.gy) + (b.w + b.d) - 0.5, f: function () { drawBuilding(b, now); } }); });
+      (S.W.trees || []).forEach(function (t) { ents.push({ d: t[0] + t[1] + 0.4, f: function () { drawTree(t); } }); });
+      (S.cars || []).forEach(function (c) { var gx = (c.axis === 'h') ? c.pos : c.line + 0.5, gy = (c.axis === 'h') ? c.line + 0.5 : c.pos; ents.push({ d: gx + gy + 0.45, f: function () { drawCar(c); } }); });
+      (S.amb || []).forEach(function (a) { ents.push({ d: a.x + a.y + 0.45, f: function () { drawAmbient(a); } }); });
+      S.chars.forEach(function (c) { ents.push({ d: c.x + c.y + 0.5, f: function () { drawChar(c, now); } }); });
+      ents.sort(function (a, b) { return a.d - b.d; }); ents.forEach(function (e) { e.f(); });
+      for (var i = S.waves.length - 1; i >= 0; i--) {
+        var w = S.waves[i]; w.t += dt; var rr2 = w.t * 560 * S.scale, al = Math.max(0, 0.7 - w.t);
+        if (al <= 0) { S.waves.splice(i, 1); continue; }
+        ctx.strokeStyle = 'rgba(56,232,255,' + al + ')'; ctx.lineWidth = 2.4 * S.scale;
+        ctx.beginPath(); ctx.ellipse(w.x, w.y, rr2, rr2 * 0.5, 0, 0, 7); ctx.stroke();
+      }
+      drawCrisis(now, rect);
+      requestAnimationFrame(frame);
+    }
+
+    function applyReactions(d) {
+      if (!d || !d.reactions || !S.W) return;
+      if (!d.silent) {
+        var pc = S.W.plaza_center || [S.W.cols / 2, S.W.rows / 2]; var p = iso(pc[0], pc[1]); S.waves.push({ x: p.x, y: p.y, t: 0 });
+      }
+      d.reactions.forEach(function (r) {
+        var c = S.chars.find(function (x) { return x.name === r.name; }); if (!c) return;
+        c.moodEmoji = r.moodEmoji || c.moodEmoji || '';
+        if (r.text) { c.bubble = r.text; c.bubbleAt = performance.now(); c.speaking = true; c.returnAt = 0; }
+        c.activity = r.activity || c.activity || ''; c.vehicle = r.vehicle || ''; c.running = !!r.running;
+        if (r.target) { c.tx = r.target[0]; c.ty = r.target[1]; }
+      });
+    }
+
+    function poll() {
+      var wj = txt('#tw-world');
+      if (wj && wj !== S.raw) { try { var W = JSON.parse(wj); S.raw = wj; loadWorld(W); } catch (e) { } }
+      var rj = txt('#tw-reactions');
+      if (rj) { try { var d = JSON.parse(rj); if (d.ts && d.ts !== S.lastTs) { S.lastTs = d.ts; applyReactions(d); } } catch (e) { } }
+      var cj = txt('#tw-crisis');
+      if (cj) { try { var cd = JSON.parse(cj); if (cd.ts && cd.ts !== S.crisisTs) { S.crisisTs = cd.ts; S.crisis = cd; } } catch (e) { } }
+    }
+
+    return {
+      start: function () { window.TINYWORLD = { applyReactions: applyReactions }; requestAnimationFrame(frame); setInterval(poll, 140); poll(); }
+    };
+  }
+
+  if (document.readyState === 'loading') document.addEventListener('DOMContentLoaded', boot);
+  else boot();
+})();

assets/map.js

@@ -0,0 +1,146 @@
+// TinyWorld — stage life: staggered bubbles, typewriter, shockwave, wander + juice.
+(function () {
+  var BUBBLE_LIFETIME_MS = 8000;
+  var STAGGER_DELAY_MS = 120;
+
+  function animateBubbles() {
+    var bubbles = document.querySelectorAll('.bubble:not([data-animated])');
+    var i = 0;
+    bubbles.forEach(function (b) {
+      b.dataset.animated = '1';
+      b.dataset.spawned = Date.now();
+      b.style.animationDelay = (i * STAGGER_DELAY_MS) + 'ms';
+      setTimeout(function () { typewriter(b); }, i * STAGGER_DELAY_MS + 120);
+      i++;
+    });
+    // Juice: trigger roster flash + mood pop for each speaking pawn
+    setTimeout(function () {
+      document.querySelectorAll('.pawn.speaking').forEach(function (p) {
+        var moodEl = p.querySelector('.pawn-mood');
+        if (moodEl) { moodEl.classList.remove('pop'); void moodEl.offsetWidth; moodEl.classList.add('pop'); }
+      });
+      document.querySelectorAll('.roster-card').forEach(function (c) {
+        c.classList.remove('speaking-flash'); void c.offsetWidth; c.classList.add('speaking-flash');
+      });
+    }, 200);
+  }
+
+  function typewriter(bubble) {
+    var node = bubble.firstChild;
+    if (!node || node.nodeType !== 3) return;
+    var full = node.textContent;
+    if (full.length < 4) return;
+    node.textContent = '';
+    var k = 0;
+    var speed = Math.max(9, Math.min(22, 520 / full.length));
+    (function step() {
+      if (k < full.length) { node.textContent += full[k++]; setTimeout(step, speed); }
+    })();
+  }
+
+  function dismissOld() {
+    document.querySelectorAll('.bubble[data-spawned]').forEach(function (b) {
+      if (Date.now() - parseInt(b.dataset.spawned, 10) > BUBBLE_LIFETIME_MS) {
+        b.style.transition = 'opacity .4s ease, transform .4s ease';
+        b.style.opacity = '0';
+        b.style.transform = 'translateX(-50%) translateY(8px) scale(.9)';
+        setTimeout(function () { if (b.parentNode) b.remove(); }, 400);
+      }
+    });
+  }
+  setInterval(dismissOld, 1000);
+
+  function fireShockwave() {
+    var sw = document.querySelector('.shockwave');
+    if (!sw) return;
+    sw.classList.remove('fire'); void sw.offsetWidth; sw.classList.add('fire');
+    setTimeout(function () { sw.classList.remove('fire'); }, 900);
+  }
+
+  // Juice: screen shake on event throw
+  function fireScreenShake() {
+    var stage = document.querySelector('.stage');
+    if (!stage) return;
+    stage.classList.remove('shake'); void stage.offsetWidth; stage.classList.add('shake');
+    setTimeout(function () { stage.classList.remove('shake'); }, 550);
+  }
+
+  // Juice: button pulse on throw
+  function fireButtonPulse() {
+    var btn = document.querySelector('#throw-btn') || document.querySelector('button.primary');
+    if (!btn) return;
+    btn.classList.remove('pulse'); void btn.offsetWidth; btn.classList.add('pulse');
+    setTimeout(function () { btn.classList.remove('pulse'); }, 2500);
+  }
+
+  // Juice: meter tick glow when vibe-fill width changes
+  function watchMeters() {
+    var fills = document.querySelectorAll('.vibe-fill');
+    fills.forEach(function (f) {
+      if (f.dataset.watched) return;
+      f.dataset.watched = '1';
+      var lastW = f.style.width;
+      var m = new MutationObserver(function () {
+        if (f.style.width !== lastW) {
+          lastW = f.style.width;
+          f.classList.remove('tick'); void f.offsetWidth; f.classList.add('tick');
+        }
+      });
+      m.observe(f, { attributes: true, attributeFilter: ['style'] });
+    });
+  }
+  setInterval(watchMeters, 500);
+
+  // Juice: day/night tint drift
+  function startTintDrift() {
+    var tint = document.querySelector('.stage-tint');
+    if (tint && !tint.classList.contains('drift')) tint.classList.add('drift');
+  }
+
+  // gentle idle wander so the town feels alive between events
+  function wander() {
+    document.querySelectorAll('.pawn').forEach(function (p) {
+      if (p.classList.contains('speaking')) return;
+      var dx = (Math.random() * 2 - 1) * 0.7;
+      var dy = (Math.random() * 2 - 1) * 0.4;
+      var t = p.querySelector('.pawn-token');
+      if (t) t.style.transform = 'translate(' + dx.toFixed(2) + 'px,' + dy.toFixed(2) + 'px)';
+    });
+  }
+  setInterval(wander, 2600);
+
+  // Juice: track mouse on buttons for radial highlight
+  document.addEventListener('mousemove', function (e) {
+    var btn = e.target.closest('button.primary, .gr-button-primary, #throw-btn');
+    if (!btn) return;
+    var rect = btn.getBoundingClientRect();
+    btn.style.setProperty('--mx', ((e.clientX - rect.left) / rect.width * 100) + '%');
+    btn.style.setProperty('--my', ((e.clientY - rect.top) / rect.height * 100) + '%');
+  });
+
+  var observer = new MutationObserver(function (muts) {
+    var fresh = false;
+    muts.forEach(function (m) {
+      m.addedNodes && m.addedNodes.forEach(function (n) {
+        if (n.nodeType === 1 && (n.querySelector ? (n.querySelector('.bubble') || n.classList.contains('bubble')) : false)) fresh = true;
+      });
+    });
+    if (fresh) {
+      setTimeout(function () {
+        animateBubbles();
+        fireShockwave();
+        fireScreenShake();
+        fireButtonPulse();
+        startTintDrift();
+      }, 40);
+    }
+  });
+
+  function watch() {
+    var root = document.querySelector('.gradio-container') || document.body;
+    if (root) { observer.observe(root, { childList: true, subtree: true }); animateBubbles(); startTintDrift(); }
+    else setTimeout(watch, 300);
+  }
+  if (document.readyState === 'loading') document.addEventListener('DOMContentLoaded', watch);
+  else watch();
+})();

assets/style.css

@@ -0,0 +1,701 @@
+@import url('https://fonts.googleapis.com/css2?family=Orbitron:wght@500;700;900&family=Rajdhani:wght@500;600;700&family=Inter:wght@400;500;600;700&display=swap');
+
+:root {
+  --bg-0: #070912;
+  --bg-1: #0e1322;
+  --bg-2: #161d31;
+  --glass: rgba(18,26,46,0.62);
+  --glass-2: rgba(12,18,34,0.8);
+  --stroke: rgba(120,160,255,0.16);
+  --stroke-bright: rgba(120,200,255,0.4);
+  --neon-cyan: #38e8ff;
+  --neon-violet: #9b6bff;
+  --neon-pink: #ff5fa2;
+  --neon-lime: #7CFFB2;
+  --gold: #ffd76a;
+  --text: #eaf0ff;
+  --muted: #8ea0c8;
+  --r: 14px;
+}
+
+* { box-sizing: border-box; }
+
+html, body {
+  background: var(--bg-0) !important;
+  margin: 0;
+}
+
+body, .gradio-container {
+  color: var(--text);
+  font-family: 'Inter', system-ui, sans-serif;
+}
+
+/* full-bleed dark backdrop so there is never a black dead-zone */
+.gradio-container {
+  background:
+    radial-gradient(1100px 500px at 15% -10%, rgba(56,232,255,0.10), transparent 60%),
+    radial-gradient(1000px 600px at 100% 0%, rgba(155,107,255,0.12), transparent 55%),
+    var(--bg-0) !important;
+  max-width: 100% !important;
+  margin: 0 auto !important;
+  padding: 12px 22px 24px !important;
+  min-height: 100vh;
+}
+
+/* hidden data channels that drive the canvas (kept in DOM, off-screen) */
+.tw-data { position: absolute !important; left: -9999px !important; width: 1px !important; height: 1px !important; overflow: hidden !important; opacity: 0 !important; pointer-events: none !important; }
+
+/* kill Gradio's default footer / "Use via API" / Settings strip */
+footer, .gradio-container > .main > .wrap > footer { display: none !important; }
+.show-api, .api-docs { display: none !important; }
+
+/* tame Gradio block chrome so our panels read as one surface */
+.gr-block, .block, .form { background: transparent !important; border: none !important; box-shadow: none !important; }
+.gr-group, .gr-box { background: transparent !important; border: none !important; }
+label > span { color: var(--muted) !important; font-family: 'Rajdhani', sans-serif !important; font-weight: 600 !important; letter-spacing: .5px; }
+.gradio-container .gap, .row { gap: 10px !important; }
+
+/* ===================== TOP BAR ===================== */
+.tw-topbar {
+  display: flex;
+  align-items: center;
+  gap: 14px;
+  padding: 14px 20px;
+  border-radius: var(--r);
+  background: linear-gradient(120deg, rgba(56,232,255,0.06), rgba(155,107,255,0.06)), var(--glass);
+  border: 1px solid var(--stroke);
+  backdrop-filter: blur(10px);
+}
+.tw-logo {
+  font-family: 'Orbitron', sans-serif;
+  font-weight: 900;
+  font-size: 24px;
+  letter-spacing: 4px;
+  color: var(--neon-cyan);
+  text-shadow: 0 0 14px rgba(56,232,255,0.5), 0 0 30px rgba(155,107,255,0.3);
+}
+.tw-tagline {
+  font-family: 'Rajdhani', sans-serif;
+  font-size: 16px; font-weight: 600; letter-spacing: 2px;
+  color: var(--muted); text-transform: uppercase;
+}
+.tw-spacer { flex: 1; }
+
+/* ===================== TICKER ===================== */
+.progress-ticker {
+  font-family: 'Rajdhani', sans-serif; font-weight: 700; font-size: 18px;
+  color: var(--muted); display: flex; align-items: center; gap: 8px;
+  padding: 8px 14px; border-radius: 10px;
+  background: var(--glass); border: 1px solid var(--stroke);
+}
+.ticker-day { color: var(--neon-cyan); }
+.ticker-sep { opacity: 0.35; }
+.ticker-chaos { color: var(--neon-violet); letter-spacing: 1px; }
+.ticker-events { color: var(--gold); }
+.mode-badge {
+  font-family: 'Rajdhani', sans-serif;
+  font-weight: 800;
+  font-size: 16px;
+  color: var(--text);
+  padding: 8px 14px;
+  border-radius: 10px;
+  background: var(--glass);
+  border: 1px solid var(--stroke);
+  white-space: nowrap;
+  overflow: hidden;
+  text-overflow: ellipsis;
+}
+.mode-live { border-color: rgba(124,255,178,0.55); color: var(--neon-lime); }
+.mode-waking, .mode-mock { border-color: rgba(255,215,106,0.55); color: var(--gold); }
+.mode-error { border-color: rgba(255,95,162,0.65); color: var(--neon-pink); }
+
+/* ===================== PANELS ===================== */
+.glass-panel {
+  background: var(--glass);
+  backdrop-filter: blur(12px);
+  border: 1px solid var(--stroke);
+  border-radius: var(--r);
+  padding: 12px;
+  height: 100%;
+}
+.panel-title {
+  font-family: 'Orbitron', sans-serif; font-weight: 700;
+  font-size: 12px; letter-spacing: 2px; text-transform: uppercase;
+  color: var(--neon-cyan); margin-bottom: 10px;
+  display: flex; align-items: center; gap: 6px;
+}
+.daily-log-inner {
+  display: grid;
+  grid-template-columns: repeat(5, minmax(0, 1fr));
+  gap: 8px;
+  padding: 10px 12px;
+  border-radius: var(--r);
+  background: var(--glass);
+  border: 1px solid var(--stroke);
+}
+.daily-row {
+  min-width: 0;
+  font-family: 'Rajdhani', sans-serif;
+  font-size: 14px;
+  line-height: 1.25;
+  color: var(--muted);
+}
+.daily-row b {
+  display: block;
+  font-family: 'Orbitron', sans-serif;
+  font-size: 11px;
+  margin-bottom: 4px;
+}
+.daily-row span {
+  display: block;
+  overflow-wrap: anywhere;
+}
+@media (max-width: 900px) {
+  .daily-log-inner { grid-template-columns: 1fr; }
+}
+
+/* ===================== ROSTER ===================== */
+.roster-rail {
+  display: flex; flex-direction: column; gap: 8px;
+}
+.roster-card {
+  display: grid;
+  grid-template-columns: 40px 1fr;
+  grid-template-rows: auto auto;
+  align-items: center;
+  gap: 2px 10px;
+  background: var(--glass);
+  border: 1px solid var(--stroke);
+  border-left: 3px solid var(--neon-violet);
+  border-radius: 12px;
+  padding: 9px 11px;
+  transition: transform .2s ease, border-color .2s ease, box-shadow .2s ease;
+}
+.roster-card:hover { transform: translateX(3px); border-left-color: var(--neon-cyan); box-shadow: 0 0 18px rgba(56,232,255,0.12); }
+.roster-emoji { grid-row: 1 / 3; font-size: 28px; text-align: center; filter: drop-shadow(0 2px 4px rgba(0,0,0,.5)); }
+.roster-name { font-family: 'Orbitron', sans-serif; font-weight: 700; font-size: 12px; color: var(--text); letter-spacing: .5px; }
+.roster-mood { font-family: 'Rajdhani', sans-serif; font-weight: 600; font-size: 13px; color: var(--muted); }
+.roster-meters { grid-column: 1 / 3; display: flex; flex-direction: column; gap: 3px; margin-top: 4px; }
+.vibe-row { display: flex; align-items: center; gap: 6px; }
+.vibe-label { font-size: 11px; width: 14px; text-align: center; }
+.vibe-track { flex: 1; height: 6px; background: rgba(0,0,0,0.35); border-radius: 4px; overflow: hidden; }
+.vibe-fill { height: 100%; border-radius: 4px; transition: width .9s cubic-bezier(.2,.8,.2,1); box-shadow: 0 0 8px currentColor; }
+.vibe-val { font-family: 'Rajdhani', sans-serif; font-weight: 700; font-size: 11px; color: var(--muted); width: 22px; text-align: right; }
+
+/* ===================== STAGE / ISOMETRIC TOWN ===================== */
+.stage {
+  position: relative;
+  width: 100%;
+  height: min(74vh, 860px);
+  border-radius: var(--r);
+  overflow: hidden;
+  border: 1px solid var(--stroke-bright);
+  box-shadow: 0 0 40px rgba(56,232,255,0.08), 0 24px 60px rgba(0,0,0,0.55);
+  background: #0a0e1c;
+  isolation: isolate;
+}
+.stage canvas { display: block; width: 100%; height: 100%; }
+.stage-vignette {
+  position: absolute; inset: 0; pointer-events: none; border-radius: var(--r);
+  box-shadow: inset 0 0 120px rgba(0,0,0,0.55), inset 0 0 30px rgba(56,232,255,0.05);
+}
+.sky {
+  position: absolute; inset: 0; height: 46%;
+  background:
+    radial-gradient(2px 2px at 20% 30%, rgba(255,255,255,.7), transparent),
+    radial-gradient(1.5px 1.5px at 60% 18%, rgba(255,255,255,.6), transparent),
+    radial-gradient(1.5px 1.5px at 80% 40%, rgba(255,255,255,.5), transparent),
+    radial-gradient(2px 2px at 38% 50%, rgba(255,255,255,.5), transparent),
+    linear-gradient(180deg, #1a1340 0%, #2a1c54 40%, #4a2a63 72%, #6b3a5a 100%);
+}
+.sky::after {
+  content: ''; position: absolute; right: 12%; top: 14%;
+  width: 46px; height: 46px; border-radius: 50%;
+  background: radial-gradient(circle at 38% 38%, #fff3d6, #ffd76a 55%, #ff9a5f 100%);
+  box-shadow: 0 0 40px rgba(255,200,120,0.55);
+}
+.iso-ground {
+  position: absolute; inset: 38% 0 0 0;
+  background: linear-gradient(180deg, #16432f 0%, #0f3424 45%, #0a261b 100%);
+}
+.iso-ground::before {
+  content: ''; position: absolute; inset: 0;
+  background-image:
+    repeating-linear-gradient(63.43deg, rgba(120,220,255,0.08) 0 1px, transparent 1px 7.2%),
+    repeating-linear-gradient(-63.43deg, rgba(120,220,255,0.08) 0 1px, transparent 1px 7.2%);
+  -webkit-mask: linear-gradient(180deg, transparent 0%, #000 16%, #000 100%);
+  mask: linear-gradient(180deg, transparent 0%, #000 16%, #000 100%);
+}
+.scene { position: absolute; inset: 0; }
+
+/* mood tint overlay */
+.stage-tint { position: absolute; inset: 0; pointer-events: none; z-index: 60; mix-blend-mode: overlay; transition: background .8s ease; }
+
+/* roads */
+.iso-road {
+  position: absolute;
+  background: linear-gradient(180deg, #2b3350, #1c2238);
+  border-top: 1px solid rgba(160,190,255,0.18);
+  border-bottom: 1px solid rgba(0,0,0,0.4);
+  box-shadow: inset 0 0 18px rgba(0,0,0,0.5);
+  transform-origin: center;
+}
+.iso-road::after {
+  content: ''; position: absolute; left: 0; right: 0; top: 50%; height: 0;
+  border-top: 2px dashed rgba(255,215,106,0.5);
+}
+
+/* buildings: front face + skewed roof + thin side */
+.bld {
+  position: absolute;
+  background: var(--front);
+  background: linear-gradient(180deg, var(--front), color-mix(in srgb, var(--front) 70%, #000));
+  border: 1px solid rgba(0,0,0,0.35);
+  border-radius: 3px 3px 2px 2px;
+  box-shadow: 0 12px 22px rgba(0,0,0,0.45);
+}
+.bld::before { /* roof */
+  content: ''; position: absolute; left: 0; top: calc(-1 * var(--rd, 34%));
+  width: 100%; height: var(--rd, 34%);
+  background: var(--roof);
+  transform: skewX(-45deg);
+  transform-origin: bottom left;
+  border-radius: 3px 3px 0 0;
+  box-shadow: 0 0 16px -2px var(--roof);
+  filter: brightness(1.05);
+}
+.bld::after { /* thin right side */
+  content: ''; position: absolute; left: 100%; top: 0;
+  width: var(--sd, 7%); height: 100%;
+  background: var(--side);
+  transform: skewY(-45deg);
+  transform-origin: top left;
+}
+.bld-sign {
+  position: absolute; left: 50%; top: 52%; transform: translate(-50%,-50%);
+  font-size: clamp(14px, 2.2vw, 26px);
+  filter: drop-shadow(0 2px 3px rgba(0,0,0,0.6));
+}
+.bld .win {
+  position: absolute; inset: 18% 14% 14% 14%;
+  background-image:
+    radial-gradient(circle at 50% 50%, rgba(255,235,160,0.85), transparent 60%);
+  background-size: 30% 40%;
+  background-repeat: repeat;
+  opacity: .35; pointer-events: none;
+}
+
+/* trees */
+.tree { position: absolute; transform: translate(-50%, -100%) scale(var(--s, 1)); }
+.tree::before { /* foliage */
+  content: ''; display: block; width: 22px; height: 22px; border-radius: 50% 50% 48% 48%;
+  background: radial-gradient(circle at 38% 32%, #4fd38a, #1f7a4a 70%, #145a36);
+  box-shadow: 0 0 10px rgba(40,180,110,0.3);
+}
+.tree::after { /* trunk */
+  content: ''; display: block; width: 5px; height: 10px; margin: -2px auto 0;
+  background: linear-gradient(#5a3a22, #3a2414); border-radius: 2px;
+}
+.prop { position: absolute; transform: translate(-50%, -100%); font-size: 26px; filter: drop-shadow(0 3px 5px rgba(0,0,0,0.55)); }
+
+/* ===================== PAWNS (characters) ===================== */
+.pawn {
+  position: absolute;
+  transform: translate(-50%, -100%);
+  transition: left 1.1s cubic-bezier(.34,.8,.34,1), top 1.1s cubic-bezier(.34,.8,.34,1);
+  display: flex; flex-direction: column; align-items: center;
+}
+.pawn-shadow {
+  position: absolute; bottom: -7px; left: 50%; transform: translateX(-50%);
+  width: 34px; height: 9px; background: rgba(0,0,0,0.4); border-radius: 50%; filter: blur(3px);
+}
+.pawn-token {
+  position: relative;
+  width: 44px; height: 44px; border-radius: 50%;
+  display: flex; align-items: center; justify-content: center;
+  font-size: 25px; line-height: 1;
+  background: radial-gradient(circle at 38% 30%, rgba(255,255,255,0.18), rgba(20,28,48,0.92));
+  border: 2px solid rgba(160,200,255,0.45);
+  box-shadow: 0 5px 12px rgba(0,0,0,0.5), inset 0 0 10px rgba(0,0,0,0.4);
+  animation: pawn-bob 3.2s ease-in-out infinite;
+}
+.pawn-mood {
+  position: absolute; top: -8px; right: -8px;
+  font-size: 15px; filter: drop-shadow(0 1px 2px rgba(0,0,0,0.7));
+}
+.pawn-name {
+  margin-top: 4px; font-family: 'Rajdhani', sans-serif; font-weight: 700; font-size: 11px;
+  color: var(--text); letter-spacing: .5px;
+  background: rgba(8,12,24,0.7); padding: 1px 7px; border-radius: 8px;
+  border: 1px solid var(--stroke); white-space: nowrap;
+}
+.pawn.speaking .pawn-token {
+  border-color: var(--neon-cyan);
+  box-shadow: 0 0 0 3px rgba(56,232,255,0.25), 0 0 22px rgba(56,232,255,0.55);
+  animation: pawn-bob 1.4s ease-in-out infinite, speak-pulse 1.4s ease-in-out infinite;
+}
+.pawn.speaking .plumb {
+  position: absolute; top: -22px; left: 50%; transform: translateX(-50%) rotate(45deg);
+  width: 9px; height: 9px; background: var(--neon-cyan);
+  box-shadow: 0 0 12px var(--neon-cyan); animation: plumb-bob 1.4s ease-in-out infinite;
+}
+@keyframes pawn-bob { 0%,100% { transform: translateY(0);} 50% { transform: translateY(-3px);} }
+@keyframes speak-pulse { 0%,100% { box-shadow: 0 0 0 3px rgba(56,232,255,0.25), 0 0 18px rgba(56,232,255,0.4);} 50% { box-shadow: 0 0 0 5px rgba(56,232,255,0.18), 0 0 28px rgba(56,232,255,0.7);} }
+@keyframes plumb-bob { 0%,100% { top: -22px;} 50% { top: -27px;} }
+
+/* speech bubbles */
+.bubble {
+  position: absolute; bottom: calc(100% + 14px); left: 50%;
+  transform: translateX(-50%);
+  background: var(--glass-2);
+  color: var(--text);
+  font-family: 'Rajdhani', sans-serif; font-weight: 600; font-size: 14px; line-height: 1.35;
+  padding: 9px 13px; border-radius: 12px; width: 190px;
+  border: 1px solid var(--stroke-bright);
+  box-shadow: 0 8px 24px rgba(0,0,0,0.55), 0 0 18px rgba(56,232,255,0.12);
+  opacity: 0; animation: bubble-spring .4s cubic-bezier(.2,.9,.3,1.2) forwards;
+  word-wrap: break-word; backdrop-filter: blur(6px);
+}
+.bubble::after {
+  content: ''; position: absolute; bottom: -8px; left: 50%; transform: translateX(-50%);
+  border-left: 8px solid transparent; border-right: 8px solid transparent;
+  border-top: 8px solid var(--glass-2);
+}
+@keyframes bubble-spring {
+  0% { opacity: 0; transform: translateX(-50%) translateY(8px) scale(.9); }
+  70% { transform: translateX(-50%) translateY(-3px) scale(1.02); }
+  100% { opacity: 1; transform: translateX(-50%) translateY(0) scale(1); }
+}
+
+/* shockwave on throw */
+.shockwave {
+  position: absolute; top: 62%; left: 50%; width: 40px; height: 24px;
+  margin: -12px 0 0 -20px; border-radius: 50%;
+  border: 2px solid var(--neon-cyan); pointer-events: none; z-index: 55; opacity: 0;
+}
+.shockwave.fire { animation: shock 0.85s ease-out forwards; }
+@keyframes shock {
+  0% { width: 40px; height: 24px; margin: -12px 0 0 -20px; opacity: .85; }
+  100% { width: 540px; height: 320px; margin: -160px 0 0 -270px; opacity: 0; }
+}
+
+.stage-idle {
+  position: absolute; left: 50%; top: 22%; transform: translateX(-50%);
+  z-index: 58; font-family: 'Rajdhani', sans-serif; font-weight: 600; font-size: 16px;
+  color: rgba(234,240,255,0.85); letter-spacing: 1px;
+  background: rgba(8,12,24,0.55); padding: 8px 16px; border-radius: 20px;
+  border: 1px solid var(--stroke); animation: idle-breathe 3s ease-in-out infinite;
+}
+@keyframes idle-breathe { 0%,100% { opacity:.55;} 50% { opacity:1;} }
+
+/* ===================== TOWN LOG ===================== */
+.town-log-inner { max-height: 460px; overflow-y: auto; padding-right: 4px; display: flex; flex-direction: column; gap: 8px; }
+.town-log-empty { font-family: 'Rajdhani', sans-serif; font-size: 15px; color: var(--muted); padding: 24px 12px; text-align: center; line-height: 1.5; }
+.log-entry {
+  padding: 8px 10px; border-radius: 10px;
+  background: rgba(10,16,30,0.5); border: 1px solid var(--stroke);
+  animation: log-in .35s ease both;
+}
+@keyframes log-in { from { opacity:0; transform: translateY(6px);} to { opacity:1; transform: none;} }
+.log-head { display: flex; align-items: center; gap: 6px; margin-bottom: 3px; }
+.log-emoji { font-size: 16px; }
+.log-name { font-family: 'Orbitron', sans-serif; font-weight: 700; font-size: 11px; color: var(--neon-cyan); }
+.log-mood { font-size: 13px; }
+.log-text { font-family: 'Rajdhani', sans-serif; font-weight: 500; font-size: 14px; color: var(--text); line-height: 1.4; }
+.log-followup { border-left: 3px solid var(--neon-violet); }
+.log-gossip { border-left: 3px solid var(--gold); font-style: italic; }
+
+/* ===================== LEARN / EXPLAINER ===================== */
+.explain-inner { display: flex; flex-direction: column; gap: 8px; max-height: 460px; overflow-y: auto; padding-right: 4px; }
+.explain-empty { font-family: 'Rajdhani', sans-serif; font-size: 14px; color: var(--muted); line-height: 1.55; padding: 14px 12px; background: rgba(10,16,30,0.4); border-radius: 10px; border: 1px dashed var(--stroke); }
+.explain-focus { font-family: 'Rajdhani', sans-serif; font-size: 14.5px; color: var(--gold); background: rgba(255,215,106,0.08); border: 1px solid rgba(255,215,106,0.25); border-radius: 10px; padding: 9px 11px; line-height: 1.45; }
+.explain-row { font-family: 'Rajdhani', sans-serif; font-weight: 500; font-size: 14px; color: var(--text); line-height: 1.45; background: rgba(10,16,30,0.5); border: 1px solid var(--stroke); border-radius: 10px; padding: 8px 11px; }
+.explain-row em { color: var(--neon-cyan); font-style: normal; font-weight: 600; }
+
+/* ===================== AUDIO CAPTIONS ===================== */
+#tw-audio .gr-audio, #tw-audio .audio-container { background: var(--glass) !important; border-radius: 12px !important; }
+.audio-cap { font-family: 'Rajdhani', sans-serif; font-size: 12.5px; color: var(--muted); line-height: 1.45; padding: 5px 4px 0; }
+.audio-cap b { color: var(--neon-cyan); }
+.audio-cap i { color: var(--neon-pink); font-style: normal; }
+#tw-actions { margin-top: 4px; align-items: end; }
+
+/* ===================== CONSOLE ===================== */
+#tw-console { padding: 14px 16px; }
+#tw-console textarea, #tw-console input[type="text"] {
+  background: var(--bg-2) !important; color: var(--text) !important;
+  border: 1px solid var(--stroke) !important; border-radius: 12px !important;
+  font-family: 'Rajdhani', sans-serif !important; font-weight: 600 !important; font-size: 18px !important;
+  padding: 14px 16px !important; min-height: 56px !important;
+}
+#tw-console textarea:focus, #tw-console input[type="text"]:focus {
+  border-color: var(--neon-cyan) !important; box-shadow: 0 0 0 3px rgba(56,232,255,0.15) !important;
+}
+.tw-hint { font-family: 'Rajdhani', sans-serif; font-size: 13px; color: var(--muted); padding: 4px 2px 0; }
+.tw-hint b { color: var(--neon-cyan); }
+
+/* ===================== BUTTONS ===================== */
+button.primary, .gr-button-primary, #throw-btn {
+  background: linear-gradient(135deg, var(--neon-cyan), var(--neon-violet)) !important;
+  color: #06121f !important;
+  font-family: 'Orbitron', sans-serif !important; font-weight: 900 !important;
+  font-size: 16px !important; letter-spacing: 1px !important;
+  border: none !important; border-radius: 12px !important; padding: 14px 18px !important;
+  cursor: pointer !important; box-shadow: 0 0 22px rgba(56,232,255,0.35) !important;
+  transition: transform .15s cubic-bezier(.2,.8,.2,1), box-shadow .2s ease !important;
+}
+button.primary:hover, .gr-button-primary:hover, #throw-btn:hover {
+  box-shadow: 0 0 30px rgba(56,232,255,0.6), 0 0 60px rgba(155,107,255,0.35) !important;
+  transform: translateY(-2px) !important;
+}
+button.primary:active, .gr-button-primary:active, #throw-btn:active { transform: scale(.96) !important; }
+
+.gr-button, button.secondary {
+  background: var(--glass) !important; color: var(--text) !important;
+  border: 1px solid var(--stroke) !important; border-radius: 12px !important;
+  font-family: 'Rajdhani', sans-serif !important; font-weight: 700 !important; font-size: 15px !important;
+  letter-spacing: .5px !important; transition: all .2s ease !important;
+}
+.gr-button:hover, button.secondary:hover { border-color: var(--neon-violet) !important; box-shadow: 0 0 14px rgba(155,107,255,0.2) !important; transform: translateY(-1px) !important; }
+
+/* dropdowns + audio */
+.gr-dropdown, .wrap.svelte-1cl284s, input[role="listbox"] {
+  background: var(--bg-2) !important; color: var(--text) !important;
+  border: 1px solid var(--stroke) !important; border-radius: 12px !important;
+}
+.gr-dropdown input { font-family: 'Rajdhani', sans-serif !important; font-weight: 600 !important; }
+
+/* ===================== FOOTER (ours) ===================== */
+.tw-footer {
+  text-align: center; padding: 18px; margin-top: 16px;
+  font-family: 'Rajdhani', sans-serif; font-size: 14px; color: var(--muted);
+  border-top: 1px solid var(--stroke); line-height: 1.9;
+}
+.tw-footer strong { color: var(--neon-cyan); }
+.footer-muted { opacity: 0.7; font-size: 12px; }
+
+/* ===================== SCROLLBARS ===================== */
+::-webkit-scrollbar { width: 7px; height: 7px; }
+::-webkit-scrollbar-track { background: transparent; }
+::-webkit-scrollbar-thumb { background: var(--bg-2); border-radius: 4px; }
+::-webkit-scrollbar-thumb:hover { background: var(--neon-violet); }
+
+/* ===================== FORCE-DARK ALL GRADIO WIDGETS (no white boxes) ===================== */
+input, textarea, select { background: var(--bg-2) !important; color: var(--text) !important; border-color: var(--stroke) !important; }
+input::placeholder, textarea::placeholder { color: rgba(150,165,200,0.6) !important; }
+/* dropdown trigger + popup list */
+.gr-dropdown, [data-testid="dropdown"], .wrap-inner, ul.options, .options {
+  background: var(--bg-2) !important; color: var(--text) !important; border: 1px solid var(--stroke) !important;
+}
+ul.options li, .options .item, li[role="option"] { background: var(--bg-2) !important; color: var(--text) !important; }
+ul.options li:hover, .options .item:hover, li[role="option"]:hover, .item.selected, li[aria-selected="true"] {
+  background: var(--neon-violet) !important; color: #0a0f1c !important;
+}
+/* audio widgets */
+.gr-audio, [data-testid="audio"], .audio-container, .controls, .waveform-container, .component-wrap {
+  background: var(--glass) !important; color: var(--text) !important; border-color: var(--stroke) !important;
+}
+.gr-audio *, [data-testid="audio"] * { color: var(--text) !important; }
+.gr-audio button, [data-testid="audio"] button { background: var(--bg-2) !important; color: var(--text) !important; border: 1px solid var(--stroke) !important; }
+[data-testid="waveform"], canvas.waveform { filter: hue-rotate(180deg) brightness(0.9); }
+/* generic svelte blocks that default to light */
+.block.padded, .form, .panel, .wrap { background: transparent !important; }
+label, label span, .gr-text-input label { color: var(--muted) !important; }
+
+/* mic warning banner */
+.tw-mic-warn {
+  position: fixed; top: 0; left: 0; right: 0; z-index: 9999;
+  background: linear-gradient(90deg, rgba(255,95,162,0.95), rgba(155,107,255,0.95));
+  color: #0a0f1c; font-family: 'Rajdhani', sans-serif; font-weight: 700; font-size: 14px;
+  text-align: center; padding: 8px 14px; letter-spacing: 0.4px;
+  box-shadow: 0 4px 18px rgba(0,0,0,0.4);
+}
+.tw-mic-warn b { color: #161038; }
+
+/* ===================== JUICE: SCREEN SHAKE ===================== */
+@keyframes screen-shake {
+  0%, 100% { transform: translate(0, 0) rotate(0); }
+  10% { transform: translate(-3px, -2px) rotate(-0.3deg); }
+  20% { transform: translate(4px, 1px) rotate(0.4deg); }
+  30% { transform: translate(-2px, 3px) rotate(-0.2deg); }
+  40% { transform: translate(3px, -1px) rotate(0.3deg); }
+  50% { transform: translate(-1px, 2px) rotate(-0.1deg); }
+  60% { transform: translate(2px, -2px) rotate(0.2deg); }
+  70% { transform: translate(-3px, 1px) rotate(-0.3deg); }
+  80% { transform: translate(1px, -1px) rotate(0.1deg); }
+  90% { transform: translate(-1px, 2px) rotate(-0.1deg); }
+}
+.stage.shake {
+  animation: screen-shake 0.5s cubic-bezier(.36,.07,.19,.97) both;
+}
+
+/* ===================== JUICE: BUTTON SQUISH ===================== */
+button.primary, .gr-button-primary, #throw-btn {
+  position: relative;
+  overflow: hidden;
+}
+button.primary::after, .gr-button-primary::after, #throw-btn::after {
+  content: '';
+  position: absolute; inset: 0;
+  background: radial-gradient(circle at var(--mx, 50%) var(--my, 50%), rgba(255,255,255,0.3), transparent 60%);
+  opacity: 0;
+  transition: opacity .3s ease;
+}
+button.primary:active::after, .gr-button-primary:active::after, #throw-btn:active::after {
+  opacity: 1;
+}
+@keyframes btn-pulse-glow {
+  0%, 100% { box-shadow: 0 0 22px rgba(56,232,255,0.35); }
+  50% { box-shadow: 0 0 36px rgba(56,232,255,0.6), 0 0 60px rgba(155,107,255,0.3); }
+}
+button.primary.pulse, .gr-button-primary.pulse {
+  animation: btn-pulse-glow 0.8s ease-in-out 3;
+}
+
+/* ===================== JUICE: METER TICK GLOW ===================== */
+@keyframes meter-tick {
+  0% { box-shadow: 0 0 8px currentColor; }
+  50% { box-shadow: 0 0 18px currentColor, 0 0 6px currentColor; }
+  100% { box-shadow: 0 0 8px currentColor; }
+}
+.vibe-fill.tick {
+  animation: meter-tick 0.6s ease-in-out;
+}
+@keyframes roster-flash {
+  0% { border-left-color: var(--neon-cyan); background: rgba(56,232,255,0.08); }
+  100% { border-left-color: var(--neon-violet); background: var(--glass); }
+}
+.roster-card.speaking-flash {
+  animation: roster-flash 0.5s ease forwards;
+}
+
+/* ===================== JUICE: MOOD BOUNCE ===================== */
+@keyframes mood-pop {
+  0% { transform: scale(1); }
+  40% { transform: scale(1.5) rotate(-8deg); }
+  70% { transform: scale(0.85) rotate(4deg); }
+  100% { transform: scale(1) rotate(0); }
+}
+.pawn-mood.pop {
+  animation: mood-pop 0.5s cubic-bezier(.34,.8,.34,1.4);
+}
+
+/* ===================== JUICE: DAY/NIGHT DRIFT ===================== */
+@keyframes tint-drift {
+  0% { background: rgba(255,170,80,0.04); }
+  25% { background: rgba(56,232,255,0.03); }
+  50% { background: rgba(155,107,255,0.04); }
+  75% { background: rgba(255,200,100,0.03); }
+  100% { background: rgba(255,170,80,0.04); }
+}
+.stage-tint.drift {
+  animation: tint-drift 30s ease-in-out infinite;
+}
+
+/* ===================== JUICE: LOG ENTRIES ===================== */
+@keyframes log-slide-in {
+  0% { opacity: 0; transform: translateX(-12px) scale(0.97); }
+  60% { transform: translateX(2px) scale(1.01); }
+  100% { opacity: 1; transform: none; }
+}
+.log-entry { animation: log-slide-in 0.4s cubic-bezier(.2,.8,.2,1) both; }
+
+/* ===================== JUICE: TITLE GLOW ===================== */
+@keyframes title-glow {
+  0%, 100% { text-shadow: 0 0 14px rgba(56,232,255,0.5), 0 0 30px rgba(155,107,255,0.3); }
+  50% { text-shadow: 0 0 20px rgba(56,232,255,0.7), 0 0 44px rgba(155,107,255,0.45); }
+}
+.tw-logo { animation: title-glow 4s ease-in-out infinite; }
+
+/* ===================== RESPONSIVE ===================== */
+@media (max-width: 1024px) {
+  .roster-rail { flex-direction: row; flex-wrap: wrap; }
+  .roster-card { flex: 1 1 45%; }
+}
+@media (max-width: 720px) {
+  .tw-logo { font-size: 18px; letter-spacing: 2px; }
+  .tw-tagline { display: none; }
+  .stage { aspect-ratio: 4 / 3; }
+  .roster-card { flex-basis: 100%; }
+}
+
+/* ---------------------------------------------- Crisis Mode */
+#tw-crisis { display: none !important; }
+
+.crisis-hud {
+  margin: 8px 0 4px;
+  padding: 12px 14px;
+  border-radius: var(--r);
+  background: linear-gradient(120deg, rgba(255,95,60,0.10), rgba(255,40,20,0.04)), var(--glass-2);
+  border: 1px solid rgba(255,120,80,0.35);
+  box-shadow: 0 0 22px rgba(255,80,40,0.12) inset;
+}
+.crisis-hud-idle {
+  color: var(--muted);
+  border: 1px dashed var(--stroke);
+  background: var(--glass);
+  box-shadow: none;
+  font-family: 'Rajdhani', sans-serif;
+}
+.crisis-top { display: flex; justify-content: space-between; align-items: baseline; gap: 12px; flex-wrap: wrap; }
+.crisis-title { font-family: 'Orbitron', sans-serif; font-weight: 700; color: #ff8a5f; letter-spacing: .5px; }
+.crisis-meta { font-family: 'Rajdhani', sans-serif; font-weight: 600; color: var(--muted); font-size: 13px; }
+.crisis-chips { display: flex; flex-wrap: wrap; gap: 6px; margin: 10px 0; }
+.crisis-chip {
+  font-family: 'Rajdhani', sans-serif; font-weight: 600; font-size: 12.5px;
+  padding: 4px 10px; border-radius: 999px; border: 1px solid var(--stroke);
+  background: var(--glass); color: var(--muted);
+}
+.crisis-chip.met { color: var(--neon-lime); border-color: rgba(124,255,178,0.5); background: rgba(124,255,178,0.10); }
+.crisis-chip.open { color: #ffd76a; border-color: rgba(255,215,106,0.35); }
+.crisis-bars { display: flex; gap: 16px; flex-wrap: wrap; }
+.crisis-bar { display: flex; align-items: center; gap: 8px; flex: 1; min-width: 180px; font-family: 'Rajdhani', sans-serif; font-weight: 600; font-size: 12.5px; color: var(--muted); }
+.crisis-bar > span { white-space: nowrap; }
+.crisis-bar > b { color: var(--text); min-width: 26px; text-align: right; }
+.cbar-track { flex: 1; height: 8px; border-radius: 6px; background: rgba(0,0,0,0.35); overflow: hidden; border: 1px solid var(--stroke); }
+.cbar-fill { height: 100%; transition: width .4s ease; }
+.cbar-fill.chaos { background: linear-gradient(90deg, #ff8a5f, #ff3b3b); }
+.cbar-fill.res { background: linear-gradient(90deg, #7CFFB2, #38e8ff); }
+
+.story-card {
+  margin: 6px 0 10px; padding: 14px 16px; border-radius: var(--r);
+  background: var(--glass-2); border: 1px solid var(--stroke);
+  animation: storyIn .4s ease;
+}
+.story-hidden { display: none; }
+.story-title { font-family: 'Orbitron', sans-serif; font-weight: 700; letter-spacing: .5px; margin-bottom: 6px; }
+.story-body { font-family: 'Rajdhani', sans-serif; font-size: 15px; line-height: 1.45; color: var(--text); }
+.story-intro { border-color: var(--stroke-bright); }
+.story-intro .story-title { color: var(--neon-cyan); }
+.story-dispatch .story-body { color: var(--muted); font-style: italic; }
+.story-win { border-color: rgba(124,255,178,0.5); background: linear-gradient(120deg, rgba(124,255,178,0.10), transparent), var(--glass-2); }
+.story-win .story-title { color: var(--neon-lime); }
+.story-loss, .story-gameover { border-color: rgba(255,95,80,0.5); background: linear-gradient(120deg, rgba(255,80,60,0.12), transparent), var(--glass-2); }
+.story-loss .story-title, .story-gameover .story-title { color: #ff7a5f; }
+.story-finale { border-color: var(--neon-violet); background: linear-gradient(120deg, rgba(155,107,255,0.16), rgba(255,95,162,0.08)), var(--glass-2); box-shadow: 0 0 30px rgba(155,107,255,0.18); }
+.story-finale .story-title { color: var(--neon-violet); }
+.story-reveal {
+  margin-top: 10px; padding-top: 10px; border-top: 1px solid var(--stroke);
+  font-family: 'Orbitron', sans-serif; font-size: 15px; line-height: 1.5; color: var(--neon-pink);
+  text-shadow: 0 0 14px rgba(255,95,162,0.5);
+}
+@keyframes storyIn { from { opacity: 0; transform: translateY(-6px); } to { opacity: 1; transform: none; } }
+
+/* ---------------------------------------------- High-contrast readability
+   Belt-and-suspenders so text is always legible on the dark theme regardless
+   of how HF Spaces initialises light/dark mode. */
+.gradio-container, .gradio-container .prose,
+.gradio-container p, .gradio-container span, .gradio-container li,
+.gradio-container label, .gradio-container .gr-box { color: #eaf0ff; }
+.gradio-container { background: var(--bg-0) !important; }
+label > span, .panel-title { color: #cdd9ff !important; }
+input, textarea, select,
+.gr-input, .gr-text-input, .gr-box input, .gr-box textarea {
+  color: #f4f8ff !important;
+  background: rgba(12,18,34,0.92) !important;
+  border-color: var(--stroke-bright) !important;
+}
+::placeholder { color: #8ea0c8 !important; opacity: 1; }
+button, .gr-button { color: #ffffff !important; }
+.gr-radio label, fieldset label { color: #eaf0ff !important; }
+.town-log-empty, .explain-empty, .audio-cap, .footer-muted, .tw-tagline { color: #aab8e0 !important; }
+.log-text, .explain-row, .daily-row span { color: #e8eeff !important; }

campaign.py

@@ -0,0 +1,263 @@
+"""TinyWorld Crisis Mode — campaign state machine.
+
+A *campaign* chains crises into a story ("Season 1 · The Long Summer"). Each
+*chapter* wraps one crisis with narrative beats and a meta-mystery clue. The town
+survives the campaign by keeping its Town Resilience above zero; the finale reveals
+that the disasters were never random — the saboteur is the player.
+
+This module is pure orchestration: it never calls the LLM itself. The UI computes
+reactions with ``agents.react`` and hands them to :func:`resolve_round`, which keeps
+the engine testable offline with scripted reactions.
+"""
+
+from dataclasses import dataclass, field
+
+import crisis as crisis_mod
+import world_state
+
+
+# Resilience cost of finishing a crisis at each grade (a clean run barely dents it).
+GRADE_COST = {"A": 0, "B": 3, "C": 7, "D": 12, "F": 25}
+
+
+@dataclass
+class Chapter:
+    id: str
+    crisis_id: str
+    intro: str = ""
+    outro_win: str = ""
+    outro_loss: str = ""
+    clue: str = ""
+
+
+@dataclass
+class Campaign:
+    id: str
+    title: str
+    chapters: list = field(default_factory=list)
+    finale_reveal: str = ""
+
+
+# --------------------------------------------------------------------------- loading
+def get_campaign_def(world):
+    data = world.get("campaign")
+    if not data:
+        return None
+    chapters = [Chapter(**ch) for ch in data.get("chapters", [])]
+    return Campaign(
+        id=data["id"],
+        title=data["title"],
+        chapters=chapters,
+        finale_reveal=data.get("finale_reveal", ""),
+    )
+
+
+def current_chapter(world):
+    camp = get_campaign_def(world)
+    if not camp:
+        return None
+    idx = world_state.get_campaign(world["id"])["chapter_index"]
+    if 0 <= idx < len(camp.chapters):
+        return camp.chapters[idx]
+    return None
+
+
+def current_crisis(world):
+    state = world_state.get_campaign(world["id"])
+    if not state.get("crisis_id"):
+        return None
+    return crisis_mod.get_crisis(world, state["crisis_id"])
+
+
+# --------------------------------------------------------------------------- lifecycle
+def start(world):
+    """Begin the campaign at chapter 1 and inject its crisis."""
+    wid = world["id"]
+    world_state.reset_campaign(wid)
+    camp = get_campaign_def(world)
+    if not camp or not camp.chapters:
+        return view(world)
+    first = camp.chapters[0]
+    world_state.campaign_update(
+        wid,
+        active=True,
+        campaign_id=camp.id,
+        chapter_index=0,
+        status="playing",
+    )
+    _inject(world, first)
+    return view(world)
+
+
+def _inject(world, chapter):
+    wid = world["id"]
+    world_state.campaign_update(
+        wid,
+        crisis_id=chapter.crisis_id,
+        crisis_round=0,
+        crisis_met=set(),
+        last_dispatch="",
+    )
+    world_state.reset_chaos(wid)
+
+
+def round_event_text(world):
+    """The event string to feed agents this round (carries prior-round feedback)."""
+    cr = current_crisis(world)
+    if not cr:
+        return ""
+    state = world_state.get_campaign(world["id"])
+    if state["crisis_round"] == 0:
+        return crisis_mod.build_event_text(cr)
+    # rebuild a progress-shaped object from the sticky met set for the feedback text
+    prior = crisis_mod.CrisisProgress(
+        crisis_id=cr.id,
+        met=state["crisis_met"],
+        unmet=[r for r in cr.requirements if r.id not in state["crisis_met"]],
+    )
+    return crisis_mod.build_event_text(cr, prior_progress=prior)
+
+
+# --------------------------------------------------------------------------- a round
+def resolve_round(world, reactions):
+    """Advance the campaign by one player round given the residents' reactions."""
+    wid = world["id"]
+    state = world_state.get_campaign(wid)
+    cr = current_crisis(world)
+    if not cr or state["status"] not in ("playing",):
+        return {"outcome": "idle", **view(world)}
+
+    round_no = state["crisis_round"] + 1
+    prog = crisis_mod.evaluate(cr, reactions, world, prior_met=state["crisis_met"])
+    world_state.campaign_update(wid, crisis_met=prog.met, crisis_round=round_no)
+
+    if prog.mvp:
+        tally = state["mvp_tally"]
+        tally[prog.mvp] = tally.get(prog.mvp, 0) + 1
+        world_state.campaign_update(wid, mvp_tally=tally)
+
+    if prog.resolved:
+        grade = _grade(round_no, world_state.get_chaos(wid), won=True)
+        dispatch = crisis_mod.narrate(cr, prog, round_no=round_no)
+        return _finish_chapter(world, cr, grade, prog, dispatch, won=True)
+
+    # not resolved — chaos ramps with each round so the time limit is the real
+    # budget (campaign owns the chaos gauge; we overwrite any per-event drift).
+    pressure = min(1.0, (round_no / cr.time_limit) * (0.8 + 0.05 * cr.severity))
+    world_state.reset_chaos(wid)
+    world_state.add_chaos(wid, pressure)
+    if round_no >= cr.time_limit:
+        grade = "F"
+        dispatch = crisis_mod.narrate(cr, prog, round_no=round_no, failed=True)
+        return _finish_chapter(world, cr, grade, prog, dispatch, won=False)
+
+    dispatch = crisis_mod.narrate(cr, prog, round_no=round_no)
+    world_state.campaign_update(wid, last_dispatch=dispatch)
+    return {"outcome": "ongoing", "dispatch": dispatch, "progress": prog, "grade": None, **view(world)}
+
+
+def _finish_chapter(world, cr, grade, prog, dispatch, won):
+    wid = world["id"]
+    state = world_state.get_campaign(wid)
+    camp = get_campaign_def(world)
+    chapter = current_chapter(world)
+
+    resilience = max(0, state["town_resilience"] - GRADE_COST.get(grade, 12))
+    grades = state["chapter_grades"] + [{
+        "chapter": chapter.id if chapter else cr.id,
+        "title": cr.title,
+        "grade": grade,
+        "rounds": state["crisis_round"],
+        "mvp": prog.mvp,
+        "won": won,
+    }]
+    clues = state["clues"] + ([chapter.clue] if chapter and chapter.clue else [])
+
+    world_state.campaign_update(
+        wid,
+        town_resilience=resilience,
+        chapter_grades=grades,
+        clues=clues,
+        last_dispatch=dispatch,
+    )
+
+    next_index = state["chapter_index"] + 1
+    outcome = "won" if won else "lost_crisis"
+    outro = (chapter.outro_win if won else chapter.outro_loss) if chapter else ""
+
+    if resilience <= 0:
+        world_state.campaign_update(wid, status="lost", crisis_id=None)
+        return {"outcome": "campaign_lost", "dispatch": dispatch, "outro": outro,
+                "grade": grade, "progress": prog, **view(world)}
+
+    if next_index >= len(camp.chapters):
+        # campaign cleared — the meta-mystery resolves
+        world_state.campaign_update(wid, status="finale", chapter_index=next_index, crisis_id=None)
+        return {"outcome": "finale", "dispatch": dispatch, "outro": outro, "grade": grade,
+                "reveal": camp.finale_reveal, "progress": prog, **view(world)}
+
+    world_state.campaign_update(wid, chapter_index=next_index)
+    _inject(world, camp.chapters[next_index])
+    return {"outcome": outcome, "dispatch": dispatch, "outro": outro, "grade": grade,
+            "progress": prog, **view(world)}
+
+
+def _grade(round_no, chaos, won):
+    if not won:
+        return "F"
+    if round_no == 1:
+        base = "A"
+    elif round_no == 2:
+        base = "B"
+    elif round_no == 3:
+        base = "C"
+    else:
+        base = "D"
+    # a messy scene (high chaos) knocks the grade down one notch
+    if chaos >= 0.6 and base in ("A", "B", "C"):
+        base = {"A": "B", "B": "C", "C": "D"}[base]
+    return base
+
+
+# --------------------------------------------------------------------------- snapshot
+def view(world):
+    """A serializable snapshot of campaign + active crisis for the UI/HUD."""
+    wid = world["id"]
+    camp = get_campaign_def(world)
+    state = world_state.get_campaign(wid)
+    cr = current_crisis(world)
+    chapter = current_chapter(world)
+
+    crisis_view = None
+    if cr:
+        crisis_view = {
+            "id": cr.id,
+            "title": cr.title,
+            "kind": cr.kind,
+            "affected_hotspot": cr.affected_hotspot,
+            "severity": cr.severity,
+            "time_limit": cr.time_limit,
+            "round": state["crisis_round"],
+            "focus": cr.focus,
+            "requirements": [
+                {"id": r.id, "label": r.label, "met": r.id in state["crisis_met"],
+                 "optional": r.optional}
+                for r in cr.requirements
+            ],
+        }
+
+    return {
+        "active": state["active"],
+        "status": state["status"],
+        "title": camp.title if camp else "",
+        "chapter_index": state["chapter_index"],
+        "chapter_count": len(camp.chapters) if camp else 0,
+        "chapter_intro": chapter.intro if chapter else "",
+        "town_resilience": state["town_resilience"],
+        "chaos": round(world_state.get_chaos(wid), 3),
+        "clues": state["clues"],
+        "chapter_grades": state["chapter_grades"],
+        "mvp_tally": state["mvp_tally"],
+        "last_dispatch": state["last_dispatch"],
+        "crisis": crisis_view,
+    }

crisis.py

@@ -0,0 +1,208 @@
+"""TinyWorld Crisis Mode — deterministic crisis resolver.
+
+A *crisis* is a structured emergency injected into the town. Each crisis declares a
+set of *requirements* — concrete responses (be at a place, take a kind of action,
+maybe be the right role) that together constitute "handling it". After the five
+residents react (via ``agents.react``), :func:`evaluate` checks their structured
+output against the requirements. This is the deterministic source of truth — the
+LLM only *speaks*; the engine decides whether the crisis is solved.
+
+Design mirrors the rest of the codebase: pure logic, no ``gradio`` import, fully
+testable offline with synthetic reaction dicts.
+"""
+
+from collections import defaultdict
+from dataclasses import dataclass, field
+
+import world_state
+
+
+# --------------------------------------------------------------------------- model
+@dataclass
+class Requirement:
+    id: str                          # "containment" | "medical" | "coordination" ...
+    label: str                       # HUD text, e.g. "🔥 Contain the fire"
+    hotspots: list = field(default_factory=list)         # any-of acceptable goto targets
+    action_keywords: list = field(default_factory=list)  # any-of words in action/text
+    role: str = None                 # if set, only this character role can satisfy it
+    weight: float = 1.0
+    optional: bool = False           # optional reqs add progress but aren't required to win
+
+
+@dataclass
+class Crisis:
+    id: str
+    title: str
+    narrative: str                   # event text injected to agents (round 1)
+    severity: int = 3                # 1-5, drives chaos accrual per unresolved round
+    focus: str = ""                  # teaching question (reused by the explainer)
+    requirements: list = field(default_factory=list)
+    time_limit: int = 4              # max rounds before failure
+    escalation: str = ""             # appended to the event each unresolved round
+    success_text: str = "The town pulled together and handled it."
+    failure_text: str = "It got away from them this time."
+    affected_hotspot: str = None     # where the crisis visually manifests on the map
+    kind: str = "fire"               # visual effect hint for the canvas (fire/flood/storm/blackout)
+
+
+@dataclass
+class CrisisProgress:
+    crisis_id: str
+    met: set = field(default_factory=set)            # requirement ids met cumulatively
+    newly_met: set = field(default_factory=set)      # ids first satisfied this round
+    unmet: list = field(default_factory=list)        # Requirement objects still open
+    contributions: dict = field(default_factory=dict)  # name -> [req_id] satisfied this round
+    progress: float = 0.0
+    resolved: bool = False
+    mvp: str = None                                  # resident who satisfied the most reqs
+
+
+# --------------------------------------------------------------------------- loading
+def load_crisis(data):
+    """Build a :class:`Crisis` from a plain dict (world files stay data-only)."""
+    reqs = [Requirement(**r) for r in data.get("requirements", [])]
+    fields = {k: v for k, v in data.items() if k != "requirements"}
+    return Crisis(requirements=reqs, **fields)
+
+
+def get_crisis(world, crisis_id):
+    for c in world.get("crises", []):
+        if c["id"] == crisis_id:
+            return load_crisis(c)
+    return None
+
+
+# --------------------------------------------------------------------------- resolver
+def _char_for(world, name):
+    return next((c for c in world.get("cast", []) if c["name"] == name), None)
+
+
+def _norm(s):
+    """Lowercase + de-accent so 'café' matches the 'cafe' hotspot key."""
+    return (s or "").lower().replace("é", "e").replace("è", "e").replace("ê", "e")
+
+
+def _mentions(hotspot, blob):
+    """The resident named the place in their own words. Use the full phrase or the
+    place-type token (clinic/office/home/park…) — never the person-name token, so
+    saying 'Priya' doesn't count as being at priya_office."""
+    if hotspot.replace("_", " ") in blob:
+        return True
+    place = hotspot.split("_")[-1]
+    return len(place) > 3 and place in blob
+
+
+def _satisfies(req, reaction, character):
+    """True when one reaction fulfils one requirement.
+
+    Each declared condition (location / keywords / role) must hold; an empty
+    condition is a wildcard. The small dialogue model often picks the wrong
+    structured ``goto`` while clearly stating the right place in its action/text,
+    so a location counts if it's the chosen ``goto`` OR named in the words.
+    """
+    if reaction.get("error"):
+        return False
+
+    blob = _norm(f"{reaction.get('action', '')} {reaction.get('text', '')}")
+
+    if req.hotspots:
+        location_ok = (reaction.get("moved_to") in req.hotspots
+                       or any(_mentions(h, blob) for h in req.hotspots))
+        if not location_ok:
+            return False
+
+    if req.action_keywords:
+        if not any(kw.lower() in blob for kw in req.action_keywords):
+            return False
+
+    if req.role:
+        if character is None or world_state.character_role(character) != req.role:
+            return False
+
+    return True
+
+
+def evaluate(crisis, reactions, world, prior_met=None):
+    """Score a round of reactions against a crisis. Met requirements are sticky."""
+    prior_met = set(prior_met or set())
+    contributions = defaultdict(list)
+    newly_met = set()
+
+    for req in crisis.requirements:
+        if req.id in prior_met:
+            continue
+        for r in reactions:
+            char = _char_for(world, r.get("name"))
+            if _satisfies(req, r, char):
+                newly_met.add(req.id)
+                contributions[r["name"]].append(req.id)
+                break  # first responder satisfies it
+
+    met = prior_met | newly_met
+
+    total_weight = sum(req.weight for req in crisis.requirements) or 1.0
+    met_weight = sum(req.weight for req in crisis.requirements if req.id in met)
+    progress = round(met_weight / total_weight, 4)
+
+    required = [req for req in crisis.requirements if not req.optional]
+    resolved = all(req.id in met for req in required)
+    unmet = [req for req in crisis.requirements if req.id not in met]
+
+    mvp = None
+    if contributions:
+        mvp = max(contributions, key=lambda n: (len(contributions[n]), n))
+
+    return CrisisProgress(
+        crisis_id=crisis.id,
+        met=met,
+        newly_met=newly_met,
+        unmet=unmet,
+        contributions=dict(contributions),
+        progress=progress,
+        resolved=resolved,
+        mvp=mvp,
+    )
+
+
+# --------------------------------------------------------------------------- round event
+def build_event_text(crisis, prior_progress=None):
+    """The event string fed to agents for a round. Subsequent rounds carry feedback
+    about what is still unhandled, which is what drives multi-round coordination."""
+    if prior_progress is None:
+        return crisis.narrative
+    parts = [crisis.narrative]
+    if crisis.escalation:
+        parts.append(crisis.escalation)
+    if prior_progress.unmet:
+        labels = ", ".join(_plain(req.label) for req in prior_progress.unmet)
+        parts.append(f"Still unresolved: {labels}.")
+    return " ".join(parts)
+
+
+# --------------------------------------------------------------------------- narration
+def narrate(crisis, progress, round_no=1, failed=False):
+    """A short 'Dispatch' verdict. Deterministic — used directly in MOCK mode and as
+    the offline fallback. The optional live-LLM flourish wraps this (see app)."""
+    if failed:
+        return f"📟 Dispatch — {crisis.title}: time ran out. {crisis.failure_text}"
+    if progress.resolved:
+        return f"📟 Dispatch — {crisis.title} contained. {crisis.success_text}"
+    if progress.newly_met:
+        done = ", ".join(_plain(_label(crisis, rid)) for rid in sorted(progress.newly_met))
+        open_ = ", ".join(_plain(req.label) for req in progress.unmet)
+        return f"📟 Dispatch — round {round_no}: {done} handled. Still open: {open_}."
+    open_ = ", ".join(_plain(req.label) for req in progress.unmet)
+    tail = f" {crisis.escalation}" if crisis.escalation else ""
+    return f"📟 Dispatch — round {round_no}: no progress. {open_} still unhandled.{tail}"
+
+
+def _label(crisis, req_id):
+    return next((r.label for r in crisis.requirements if r.id == req_id), req_id)
+
+
+def _plain(label):
+    """Strip a leading emoji so labels read cleanly mid-sentence."""
+    parts = label.split(" ", 1)
+    if len(parts) == 2 and not parts[0].isascii():
+        return parts[1]
+    return label

decide.py

@@ -0,0 +1,293 @@
+import json
+import os
+import random
+import re
+import time
+from dataclasses import dataclass, field
+
+
+MOODS = [
+    "happy", "stressed", "bored", "excited", "hungry",
+    "tired", "nostalgic", "curious", "proud", "embarrassed",
+]
+
+SURPRISE_SEEDS = [
+    "Slip in one oddly specific detail from earlier today.",
+    "React as if this event confirms a private theory you never told anyone.",
+    "Let a petty personal concern steer part of your response.",
+    "Compare the event to a memory that still annoys you.",
+    "Say one thing confidently, then soften or complicate it.",
+    "Ask one pointed question that reveals your bias.",
+    "Treat one small part of the event as the real emergency.",
+    "Reveal a secret wish connected to the situation.",
+    "Interpret the event through your relationship with someone nearby.",
+    "End with a surprising offer, warning, or demand.",
+]
+
+MODAL_REACT_URL = os.environ.get(
+    "MODAL_REACT_URL",
+    "https://mitvho09--tinyworld-inference-react-endpoint.modal.run",
+)
+
+
+@dataclass
+class Decision:
+    think: str
+    say: str
+    action: str
+    goto: str
+    mood: str
+    need_deltas: dict = field(default_factory=dict)
+    degraded: bool = False
+    error: bool = False
+    warning: str = ""
+    raw: str = ""
+    latency: float | None = None
+
+
+def allowed_hotspots(world):
+    return list(((world.get("board", {}) or {}).get("hotspots_tile") or {}).keys())
+
+
+def current_activity(character, world, position):
+    activities = (world.get("board", {}) or {}).get("activities", {})
+    if character["name"] in activities:
+        return activities[character["name"]].get("label", "going about their day")
+    if position:
+        return f"near {position.replace('_', ' ')}"
+    return "going about their day"
+
+
+def build_decision_prompt(character, event, mood, memory, relationships, world, position=None, needs=None, command=None):
+    first = character["name"].split()[0]
+    hotspots = allowed_hotspots(world)
+    needs = needs or {"energy": 50, "hunger": 50, "social": 50}
+    activity = current_activity(character, world, position)
+    memory_text = "; ".join(memory[-4:]) if memory else "nothing recent"
+    seed = random.choice(SURPRISE_SEEDS)
+
+    command_text = ""
+    if command and command.get("type") == "directed_command":
+        command_text = (
+            "\nDirected command:\n"
+            f"- Addressee: {character['name']}\n"
+            f"- Instruction to obey unless strongly out of character: {command.get('instruction', event)}\n"
+            f"- Required destination if relevant: {command.get('goto') or 'none'}\n"
+            "If you refuse, explain why in the say field and use goto=stay.\n"
+        )
+
+    return f"""You are controlling one TinyWorld character.
+
+Persona:
+- Name: {character['name']}
+- Age/job: {character['age']}, {character['job']}
+- Traits: {', '.join(character.get('traits', []))}
+- Backstory: {character.get('backstory', '')}
+- Relationships: {relationships}
+
+Current state:
+- Mood before deciding: {mood}
+- Current place: {position or character.get('home', 'unknown')}
+- Current activity: {activity}
+- Needs: energy={needs.get('energy', 50)}, hunger={needs.get('hunger', 50)}, social={needs.get('social', 50)}
+- Recent memory: {memory_text}
+
+Allowed goto values: {', '.join(hotspots)}, stay
+Triggering input: {event}
+{command_text}
+Surprise instruction: {seed}
+
+Return ONLY strict JSON with exactly these keys:
+{{
+  "think": "one short private thought, max 120 chars",
+  "say": "what {first} says aloud, 1-2 short sentences, in-character",
+  "action": "a concrete verb phrase describing what {first} does",
+  "goto": "one allowed goto value or stay",
+  "mood": "one of: {', '.join(MOODS)}",
+  "need_deltas": {{"energy": 0, "hunger": 0, "social": 0}}
+}}
+
+No markdown, no commentary, no labels outside the JSON object."""
+
+
+def decide_real(character, event, mood, memory, relationships, world, position=None, needs=None, command=None):
+    prompt = build_decision_prompt(character, event, mood, memory, relationships, world, position, needs, command)
+    raw, latency = _call_modal(character, event, prompt)
+    decision = parse_decision(raw, world, previous_mood=mood)
+    decision.latency = latency
+    if decision.degraded:
+        retry_prompt = prompt + "\n\nYour previous response was invalid. Return ONLY the JSON object."
+        raw_retry, retry_latency = _call_modal(character, event, retry_prompt, timeout=45.0)
+        decision = parse_decision(raw_retry, world, previous_mood=mood)
+        decision.latency = retry_latency
+    return decision
+
+
+def mock_decision(character, event, mood, world, command=None):
+    hotspots = allowed_hotspots(world)
+    goto = command.get("goto") if command and command.get("goto") in hotspots else _event_goto(event, hotspots)
+    chosen_mood = random.choice(MOODS)
+    first = character["name"].split()[0]
+    if command and command.get("type") == "directed_command":
+        instruction = command.get("instruction") or event
+        action = f"follow the instruction: {instruction}"
+    else:
+        action = _mock_action(character, goto)
+    templates = [
+        f"{first} says this feels {chosen_mood}, but I'm going to {action}.",
+        f"I don't love surprises like this. I'll {action} and see what is really going on.",
+        f"This is exactly the sort of thing my day was missing. I'm going to {action}.",
+    ]
+    return Decision(
+        think=f"{first} connects the event to their role.",
+        say=random.choice(templates),
+        action=action,
+        goto=goto,
+        mood=chosen_mood,
+        need_deltas={
+            "energy": random.randint(-8, 4),
+            "hunger": random.randint(-3, 6),
+            "social": random.randint(-4, 8),
+        },
+    )
+
+
+def parse_decision(raw, world, previous_mood="curious"):
+    data = _extract_json(raw)
+    if data is None:
+        return _safe_decision(previous_mood, "malformed JSON", raw)
+
+    hotspots = allowed_hotspots(world)
+    think = _limit(_clean_text(data.get("think", "")), 120)
+    say = _limit(_clean_dialogue(data.get("say", "")), 220)
+    action = _limit(_clean_text(data.get("action", "")), 160)
+    goto = _clean_goto(data.get("goto", "stay"), hotspots)
+    mood = data.get("mood", previous_mood)
+    if mood not in MOODS:
+        mood = previous_mood if previous_mood in MOODS else "curious"
+
+    deltas = data.get("need_deltas", {})
+    if not isinstance(deltas, dict):
+        deltas = {}
+    need_deltas = {
+        "energy": _clamp_int(deltas.get("energy", 0), -25, 25),
+        "hunger": _clamp_int(deltas.get("hunger", 0), -25, 25),
+        "social": _clamp_int(deltas.get("social", 0), -25, 25),
+    }
+
+    if not say:
+        return _safe_decision(mood, "empty dialogue after cleaning", raw)
+    if not action:
+        action = "stay alert and watch what happens next"
+    return Decision(think, say, action, goto, mood, need_deltas, raw=raw)
+
+
+def _call_modal(character, event, prompt, timeout=180.0):
+    import httpx
+
+    payload = {
+        "event": event,
+        "characters": [character],
+        "prompts": {character["name"]: prompt},
+    }
+    started = time.time()
+    with httpx.Client(timeout=timeout, follow_redirects=True) as client:
+        response = client.post(MODAL_REACT_URL, json=payload)
+        response.raise_for_status()
+        data = response.json()
+    reactions = data.get("reactions", [])
+    if not reactions or reactions[0].get("error"):
+        message = reactions[0].get("text", "model unreachable") if reactions else "model unreachable"
+        raise RuntimeError(message)
+    return reactions[0].get("text", ""), round(time.time() - started, 2)
+
+
+def _extract_json(raw):
+    raw = (raw or "").strip()
+    try:
+        return json.loads(raw)
+    except json.JSONDecodeError:
+        match = re.search(r"\{.*\}", raw, re.DOTALL)
+        if not match:
+            return None
+        try:
+            return json.loads(match.group(0))
+        except json.JSONDecodeError:
+            return None
+
+
+def _clean_goto(value, hotspots):
+    goto = str(value or "stay").strip().lower().replace(" ", "_")
+    goto = re.sub(r"[^a-z0-9_]", "", goto)
+    if goto == "stay":
+        return "stay"
+    return goto if goto in hotspots else "stay"
+
+
+def _safe_decision(mood, warning, raw):
+    return Decision(
+        think="The model output could not be used.",
+        say="I need a second before I can make sense of that.",
+        action="stay put and reassess",
+        goto="stay",
+        mood=mood if mood in MOODS else "curious",
+        need_deltas={"energy": 0, "hunger": 0, "social": 0},
+        degraded=True,
+        warning=warning,
+        raw=raw or "",
+    )
+
+
+def _clean_text(value):
+    text = re.sub(r"[\x00-\x1f\x7f]", " ", str(value or ""))
+    return re.sub(r"\s+", " ", text).strip()
+
+
+def _clean_dialogue(value):
+    text = _clean_text(value)
+    text = re.sub(r"\[[^\]]*\]", "", text)
+    text = re.sub(r"\*[^*]*\*", "", text)
+    text = re.sub(r"^(say|do|think|goto)\s*:\s*", "", text, flags=re.IGNORECASE)
+    meta = re.compile(r"(as an ai|the prompt|return only json|1-2 sentences|in character)", re.IGNORECASE)
+    parts = [p.strip(" \"'") for p in re.split(r"(?<=[.!?])\s+", text) if p.strip()]
+    keep = [p for p in parts if not meta.search(p)]
+    return " ".join(keep[:2]).strip()
+
+
+def _limit(text, max_chars):
+    text = _clean_text(text)
+    return text[:max_chars].rstrip()
+
+
+def _clamp_int(value, low, high):
+    try:
+        value = int(value)
+    except (TypeError, ValueError):
+        value = 0
+    return max(low, min(high, value))
+
+
+def _event_goto(event, hotspots):
+    e = event.lower()
+    rules = [
+        (("clinic", "hurt", "injur", "sick", "emergency", "storm"), "nia_clinic"),
+        (("school", "student", "class", "teacher"), "school"),
+        (("cafe", "café", "coffee", "food", "hungry"), "cafe"),
+        (("park", "tree", "glow", "object", "cat", "mural"), "park"),
+        (("office", "city", "budget", "permit", "power"), "priya_office"),
+        (("home", "rest"), "marta_home"),
+    ]
+    for words, goto in rules:
+        if any(word in e for word in words) and goto in hotspots:
+            return goto
+    return "square" if "square" in hotspots else "stay"
+
+
+def _mock_action(character, goto):
+    place = goto.replace("_", " ")
+    role = character.get("job", "neighbor")
+    return random.choice([
+        f"go to {place} and check the situation",
+        f"use my {role} instincts at {place}",
+        f"head for {place} before rumors outrun the facts",
+    ])

events.py

@@ -0,0 +1,20 @@
+import random
+
+CHAOS_EVENTS = [
+    "A food truck rolls in offering free pizza to everyone on the block.",
+    "A mysterious glowing object lands in the park.",
+    "The mayor announces all shops on this street must close by Friday.",
+    "Someone on the block wins the lottery and starts spending lavishly.",
+    "A local resident goes viral on social media for a ridiculous dance.",
+    "The water supply is cut off for 24 hours — no one knows why.",
+    "A celebrity is spotted moving into the apartment on 3rd floor.",
+    "City Hall passes a new law: everyone must work from home starting tomorrow.",
+    "A free outdoor concert is announced for tonight in the parking lot.",
+    "A strange smell drifts from the abandoned building on the corner.",
+    "Forecast says it will snow two inches in the next two hours — in June.",
+    "A mysterious new neighbor arrives with no name tag and a locked suitcase.",
+]
+
+
+def random_event() -> str:
+    return random.choice(CHAOS_EVENTS)

inference.py

@@ -0,0 +1,107 @@
+"""In-process GPU inference for Hugging Face Spaces ZeroGPU.
+
+Mirrors modal_app.py, but instead of calling Modal over HTTP the models run
+locally inside the Space behind @spaces.GPU (which allocates a ZeroGPU for the
+duration of each call). Selected by TINYWORLD_INFER=local.
+
+Imported LAZILY (only when the local backend is active) because it pulls in
+torch / transformers / voxcpm / whisper — heavy deps the offline test suite and
+the Modal-backed path never need. Models are loaded on CPU once and moved to CUDA
+inside the GPU-decorated functions (CUDA is only available there on ZeroGPU).
+"""
+
+import os
+import re
+import tempfile
+
+import spaces
+import torch
+
+LLM_MODEL_ID = os.environ.get("TINYWORLD_LLM", "nvidia/Nemotron-Mini-4B-Instruct")
+VOICE_MODEL_ID = os.environ.get("TINYWORLD_VOICE_MODEL", "openbmb/VoxCPM2")
+WHISPER_SIZE = os.environ.get("TINYWORLD_WHISPER", "base")
+
+_llm = None
+_tok = None
+_voice = None
+_whisper = None
+
+
+# --------------------------------------------------------------------------- LLM
+def _load_llm():
+    global _llm, _tok
+    if _llm is None:
+        from transformers import AutoModelForCausalLM, AutoTokenizer
+        print(f"[inference] loading {LLM_MODEL_ID} …")
+        _tok = AutoTokenizer.from_pretrained(LLM_MODEL_ID, trust_remote_code=True)
+        _llm = AutoModelForCausalLM.from_pretrained(
+            LLM_MODEL_ID, torch_dtype=torch.bfloat16, trust_remote_code=True,
+        )
+    return _llm, _tok
+
+
+def _strip_think(text):
+    text = re.sub(r"<think>.*?</think>", "", text, flags=re.DOTALL).strip()
+    if "<think>" in text:
+        parts = text.split("</think>")
+        text = parts[-1].strip() if len(parts) > 1 else text
+    return text.strip()
+
+
+@spaces.GPU(duration=120)
+def generate_batch(prompts):
+    """One raw completion per prompt, all in a single GPU allocation. Returns a
+    list of raw strings aligned with ``prompts`` (the reaction engine parses them)."""
+    mdl, tok = _load_llm()
+    mdl.to("cuda")
+    outputs = []
+    for prompt in prompts:
+        messages = [{"role": "user", "content": prompt}]
+        input_text = tok.apply_chat_template(messages, add_generation_prompt=True, tokenize=False)
+        inputs = tok(input_text, return_tensors="pt").to("cuda")
+        with torch.no_grad():
+            out = mdl.generate(
+                **inputs, max_new_tokens=400, do_sample=True, temperature=0.8, top_p=0.9,
+            )
+        new = out[0][inputs["input_ids"].shape[1]:]
+        text = tok.decode(new, skip_special_tokens=True).strip()
+        outputs.append(_strip_think(text))
+    return outputs
+
+
+# --------------------------------------------------------------------------- TTS
+def _load_voice():
+    global _voice
+    if _voice is None:
+        from voxcpm import VoxCPM
+        print(f"[inference] loading {VOICE_MODEL_ID} …")
+        _voice = VoxCPM.from_pretrained(VOICE_MODEL_ID)
+    return _voice
+
+
+@spaces.GPU(duration=60)
+def synthesize_voice(text, voice_desc):
+    """Returns a path to a WAV file (matches voice.generate_voice's contract)."""
+    import soundfile as sf
+    model = _load_voice()
+    wav = model.generate(text=f"{voice_desc}{text}", cfg_value=2.0, inference_timesteps=10)
+    path = os.path.join(tempfile.gettempdir(), f"tinyworld_voice_{os.getpid()}.wav")
+    sf.write(path, wav, model.tts_model.sample_rate)
+    return path
+
+
+# --------------------------------------------------------------------------- ASR
+def _load_whisper():
+    global _whisper
+    if _whisper is None:
+        import whisper
+        print(f"[inference] loading Whisper {WHISPER_SIZE} …")
+        _whisper = whisper.load_model(WHISPER_SIZE)
+    return _whisper
+
+
+@spaces.GPU(duration=60)
+def transcribe_audio(audio_path):
+    model = _load_whisper()
+    result = model.transcribe(audio_path, fp16=True)
+    return (result.get("text") or "").strip()

packages.txt

@@ -0,0 +1 @@
+ffmpeg

requirements.txt

@@ -0,0 +1,15 @@
+# TinyWorld Space runtime for ZeroGPU (in-process inference via inference.py).
+# Use this as requirements.txt ONLY on a PRO account with ZeroGPU hardware, and set
+# the Space variable TINYWORLD_INFER=local. Also keep packages.txt (ffmpeg) for Whisper.
+gradio>=6.18.0
+httpx
+numpy
+soundfile
+spaces
+torch
+transformers
+accelerate
+sentencepiece
+voxcpm
+openai-whisper
+cohere

router.py

@@ -0,0 +1,119 @@
+import re
+
+
+COMMAND_VERBS = {
+    "go", "head", "walk", "run", "visit", "check", "rest", "help",
+    "tell", "make", "ask", "send", "move", "bring", "look",
+}
+
+BASE_LOCATION_ALIASES = {
+    "clinic": "nia_clinic",
+    "hospital": "nia_clinic",
+    "nurse": "nia_clinic",
+    "cafe": "cafe",
+    "café": "cafe",
+    "coffee": "cafe",
+    "school": "school",
+    "class": "school",
+    "park": "park",
+    "fountain": "fountain",
+    "square": "square",
+    "plaza": "square",
+    "office": "priya_office",
+    "city hall": "priya_office",
+    "shop": "shop",
+    "store": "shop",
+}
+
+
+def classify(text, world):
+    raw = (text or "").strip()
+    if not raw:
+        return {"type": "noop", "text": raw, "addressees": [], "instruction": "", "goto": None}
+    if not re.search(r"[A-Za-z0-9]", raw):
+        return {"type": "ambient", "text": raw, "addressees": [], "instruction": raw, "goto": None}
+
+    cast = world.get("cast", [])
+    names = _matched_names(raw, cast)
+    lowered = raw.lower()
+    looks_command = bool(names) and (
+        _starts_with_name_command(lowered, names)
+        or lowered.startswith("tell ")
+        or lowered.startswith("make ")
+        or lowered.startswith("ask ")
+        or any(re.search(rf"\b{verb}\b", lowered) for verb in COMMAND_VERBS)
+    )
+    if looks_command:
+        instruction = _strip_command_prefix(raw, names)
+        goto = resolve_location(instruction, world, cast, names)
+        return {
+            "type": "directed_command",
+            "text": raw,
+            "addressees": names,
+            "instruction": instruction,
+            "goto": goto,
+        }
+
+    return {"type": "world_event", "text": raw, "addressees": [], "instruction": raw, "goto": None}
+
+
+def resolve_location(text, world, cast=None, addressees=None):
+    lowered = (text or "").lower()
+    hotspots = ((world.get("board", {}) or {}).get("hotspots_tile") or {})
+
+    if "home" in lowered and cast and addressees and len(addressees) == 1:
+        char = next((c for c in cast if c["name"] == addressees[0]), None)
+        home = char.get("home") if char else None
+        if home in hotspots:
+            return home
+
+    aliases = dict(BASE_LOCATION_ALIASES)
+    if "nurse_office" in hotspots:
+        aliases["clinic"] = "nurse_office"
+        aliases["nurse"] = "nurse_office"
+        aliases["nurse office"] = "nurse_office"
+    if "quad" in hotspots:
+        aliases["quad"] = "quad"
+        aliases["campus"] = "quad"
+    if "riverside_walk" in hotspots:
+        aliases["river"] = "riverside_walk"
+        aliases["riverside"] = "riverside_walk"
+    for key in hotspots:
+        aliases[key] = key
+        aliases[key.replace("_", " ")] = key
+        aliases[key.replace("_", "")] = key
+
+    for phrase, hotspot in sorted(aliases.items(), key=lambda item: len(item[0]), reverse=True):
+        if phrase in lowered and hotspot in hotspots:
+            return hotspot
+    return None
+
+
+def _matched_names(text, cast):
+    lowered = text.lower()
+    matches = []
+    for char in cast:
+        first = char["name"].split()[0].lower()
+        if re.search(rf"\b{re.escape(first)}\b", lowered):
+            matches.append(char["name"])
+    return matches
+
+
+def _starts_with_name_command(lowered, names):
+    first_names = [name.split()[0].lower() for name in names]
+    for first in first_names:
+        if re.match(rf"^\s*{re.escape(first)}\s*[,:\-]\s*", lowered):
+            return True
+    return False
+
+
+def _strip_command_prefix(text, names):
+    instruction = text.strip()
+    first_names = "|".join(re.escape(name.split()[0]) for name in names)
+    patterns = [
+        rf"^\s*(?:tell|ask|make|send)\s+(?:{first_names})\s+(?:to\s+)?",
+        rf"^\s*(?:{first_names})\s*[,:\-]\s*",
+    ]
+    for pattern in patterns:
+        instruction = re.sub(pattern, "", instruction, flags=re.IGNORECASE).strip()
+    return instruction or text.strip()

transcribe.py

@@ -0,0 +1,96 @@
+import os
+from pathlib import Path
+
+MODAL_TRANSCRIBE_URL = os.environ.get(
+    "MODAL_TRANSCRIBE_URL",
+    "https://mitvho09--tinyworld-inference-transcribe-endpoint.modal.run",
+)
+
+MOCK_SENTENCES = [
+    "A street parade just showed up out of nowhere.",
+    "Someone left a mysterious package on the sidewalk.",
+    "The neighbors are arguing about something loud again.",
+    "There's a strange light coming from the old building.",
+    "I just saw something really weird down the block.",
+]
+
+
+def _is_mock() -> bool:
+    return os.environ.get("TINYWORLD_MOCK", "0") == "1"
+
+
+def _backend() -> str:
+    return os.environ.get("TINYWORLD_INFER", "modal").lower()
+
+
+def transcribe(audio_path: str | None) -> str:
+    if not audio_path or _is_mock():
+        import random
+        return random.choice(MOCK_SENTENCES)
+
+    if _backend() == "local":
+        try:
+            import inference  # ZeroGPU Whisper, imported lazily
+            text = inference.transcribe_audio(audio_path)
+            if text:
+                return text
+        except Exception as e:
+            print(f"[transcribe] local failed: {e}")
+
+    if MODAL_TRANSCRIBE_URL:
+        try:
+            text = _modal_transcribe(audio_path)
+            if text:
+                return text
+        except Exception as e:
+            print(f"[transcribe] Modal failed: {e}")
+
+    try:
+        return _cohere_transcribe(audio_path)
+    except Exception as e:
+        print(f"[transcribe] failed: {e}")
+        return ""
+
+
+def _modal_transcribe(audio_path: str) -> str:
+    import httpx
+
+    path = Path(audio_path)
+    headers = {"x-audio-suffix": path.suffix or ".wav"}
+    with path.open("rb") as f:
+        audio_bytes = f.read()
+
+    with httpx.Client(timeout=300.0, follow_redirects=True) as client:
+        response = client.post(
+            MODAL_TRANSCRIBE_URL,
+            content=audio_bytes,
+            headers=headers,
+        )
+        response.raise_for_status()
+
+    data = response.json()
+    return (data.get("text") or "").strip()
+
+
+def _cohere_transcribe(audio_path: str) -> str:
+    api_key = os.environ.get("COHERE_API_KEY", "")
+    if not api_key:
+        print("[transcribe] no COHERE_API_KEY set")
+        return ""
+
+    import cohere
+
+    co = cohere.ClientV2(api_key=api_key)
+
+    with open(audio_path, "rb") as f:
+        response = co.audio.transcriptions.create(
+            model="cohere-transcribe-03-2026",
+            language="en",
+            file=f,
+        )
+
+    return response.text.strip() if response.text else ""
+
+
+if __name__ == "__main__":
+    print("Mock transcribe:", transcribe(None))

voice.py

@@ -0,0 +1,88 @@
+import os
+import tempfile
+import numpy as np
+
+MODAL_VOICE_URL = os.environ.get(
+    "MODAL_VOICE_URL",
+    "https://mitvho09--tinyworld-inference-voice-endpoint.modal.run",
+)
+VOICE_TIMEOUT = float(os.environ.get("TINYWORLD_VOICE_TIMEOUT", "25"))
+
+
+def _is_mock() -> bool:
+    return os.environ.get("TINYWORLD_MOCK", "0") == "1"
+
+
+def _backend() -> str:
+    return os.environ.get("TINYWORLD_INFER", "modal").lower()
+
+
+def build_voice_description(character) -> str:
+    return character.get("voice_description", "(a neutral voice)")
+
+
+def generate_voice(text: str, voice_desc: str) -> str:
+    try:
+        if _is_mock():
+            return _mock_generate(text)
+        if _backend() == "local":
+            import inference  # ZeroGPU VoxCPM2, imported lazily
+            return inference.synthesize_voice(text, voice_desc)
+        return _real_generate(text, voice_desc)
+    except Exception as e:
+        print(f"[voice] generation failed: {e}")
+        return _mock_generate(text) if _is_mock() else None
+
+
+def _mock_generate(text: str) -> str:
+    # Audible placeholder so the voice/hear features are verifiable without a GPU.
+    sample_rate = 24000
+    duration = min(1.6, 0.5 + 0.03 * len(text.split()))
+    t = np.linspace(0, duration, int(sample_rate * duration), endpoint=False)
+    base = 150 + (hash(text) % 120)  # per-line pitch
+    wobble = 1 + 0.04 * np.sin(2 * np.pi * 5 * t)  # gentle speech-like wobble
+    tone = 0.22 * np.sin(2 * np.pi * base * wobble * t)
+    tone += 0.08 * np.sin(2 * np.pi * base * 2 * t)
+    env = np.minimum(1.0, np.minimum(t * 12, (duration - t) * 8))  # fade in/out
+    audio = (tone * env).astype(np.float32)
+    path = os.path.join(tempfile.gettempdir(), f"tinyworld_voice_{os.getpid()}.wav")
+    try:
+        import soundfile as sf
+        sf.write(path, audio, sample_rate)
+    except ImportError:
+        import wave
+        with wave.open(path, "w") as wf:
+            wf.setnchannels(1)
+            wf.setsampwidth(2)
+            wf.setframerate(sample_rate)
+            wf.writeframes((audio * 32767).astype(np.int16).tobytes())
+    return path
+
+
+def _real_generate(text: str, voice_desc: str) -> str:
+    try:
+        import httpx
+
+        payload = {"text": text, "voice_desc": voice_desc}
+
+        with httpx.Client(timeout=VOICE_TIMEOUT, follow_redirects=True) as client:
+            resp = client.post(MODAL_VOICE_URL, json=payload)
+            resp.raise_for_status()
+
+        path = os.path.join(tempfile.gettempdir(), f"tinyworld_voice_{os.getpid()}.wav")
+        with open(path, "wb") as f:
+            f.write(resp.content)
+
+        return path
+
+    except Exception as e:
+        print(f"[voice] Modal call failed: {e}")
+        return None
+
+
+if __name__ == "__main__":
+    import characters as c
+    path = generate_voice("Hello there!", c.CHARACTERS[0]["voice_description"])
+    print(path)
+    assert os.path.exists(path), f"File not found: {path}"
+    print("OK")

world_state.py

@@ -0,0 +1,412 @@
+import random
+import threading
+from collections import defaultdict, deque
+
+_lock = threading.Lock()
+
+_states = {}
+
+DEFAULT_SCHEDULES = {
+    "student": [
+        [7, 8, "school", "getting ready for class", {"energy": -2, "social": 1}],
+        [8, 15, "school", "in class", {"energy": -8, "social": 6}],
+        [15, 17, "cafe", "after-school break", {"hunger": -10, "social": 8}],
+        [17, 22, "school", "homework and hobbies", {"energy": -4}],
+        [22, 7, "school", "sleeping", {"energy": 25}],
+    ],
+    "worker": [
+        [7, 9, "cafe", "breakfast before work", {"hunger": -8, "energy": 3}],
+        [9, 17, "priya_office", "working", {"energy": -10, "social": 3}],
+        [17, 19, "park", "walking after work", {"energy": -2, "social": 4}],
+        [19, 23, "cafe", "evening errands", {"hunger": -8, "social": 3}],
+        [23, 7, "priya_office", "resting", {"energy": 24}],
+    ],
+    "shopkeeper": [
+        [6, 8, "shop", "opening up", {"energy": -2}],
+        [8, 18, "shop", "serving customers", {"energy": -9, "social": 8}],
+        [18, 21, "cafe", "closing-day dinner", {"hunger": -10, "social": 3}],
+        [21, 6, "shop", "resting", {"energy": 22}],
+    ],
+    "medic": [
+        [7, 8, "cafe", "coffee before shift", {"hunger": -6, "energy": 2}],
+        [8, 18, "nia_clinic", "clinic shift", {"energy": -12, "social": 5}],
+        [18, 20, "park", "decompressing", {"energy": -2, "social": 2}],
+        [20, 7, "nia_clinic", "resting on call", {"energy": 24}],
+    ],
+    "retiree": [
+        [6, 9, "marta_home", "quiet morning routine", {"energy": 4}],
+        [9, 12, "shop", "checking the old storefront", {"energy": -3, "social": 3}],
+        [12, 16, "park", "watching the neighborhood", {"energy": -2, "social": 4}],
+        [16, 20, "cafe", "tea and gossip", {"hunger": -8, "social": 5}],
+        [20, 6, "marta_home", "resting at home", {"energy": 20}],
+    ],
+}
+
+
+def _new_state(world_id):
+    return {
+        "world_id": world_id,
+        "day": 1,
+        "event_count": 0,
+        "chaos": 0.0,
+        "town_mood": 0.0,
+        "game_time": 7.0,
+        "paused": False,
+        "vibes": {},
+        "needs": {},
+        "affinity": {},
+        "moods": {},
+        "memory": defaultdict(lambda: deque(maxlen=4)),
+        "timeline": defaultdict(lambda: deque(maxlen=20)),
+        "reflections": {},
+        "positions": {},
+        "activities": {},
+        "campaign": _new_campaign(),
+    }
+
+
+def _new_campaign():
+    return {
+        "active": False,
+        "campaign_id": None,
+        "chapter_index": 0,
+        "crisis_id": None,
+        "crisis_round": 0,
+        "crisis_met": set(),       # requirement ids met in the current crisis (sticky)
+        "town_resilience": 100,    # campaign-long score, 0-100
+        "clues": [],               # meta-mystery breadcrumbs revealed so far
+        "chapter_grades": [],      # [{chapter, title, grade, rounds, mvp}]
+        "mvp_tally": {},           # name -> times they were crisis MVP
+        "status": "idle",          # idle | playing | won | lost | finale
+        "last_dispatch": "",       # most recent narrated verdict
+    }
+
+
+def get_state(world_id):
+    with _lock:
+        if world_id not in _states:
+            _states[world_id] = _new_state(world_id)
+        return _states[world_id]
+
+
+def reset_world(world_id):
+    with _lock:
+        _states[world_id] = _new_state(world_id)
+        return _states[world_id]
+
+
+def init_cast(world):
+    state = get_state(world["id"])
+    with _lock:
+        for c in world["cast"]:
+            name = c["name"]
+            if name not in state["vibes"]:
+                state["vibes"][name] = {"energy": 0.6, "social": 0.5}
+            if name not in state["needs"]:
+                state["needs"][name] = c.get("needs", {"energy": 60, "hunger": 35, "social": 50}).copy()
+            if name not in state["moods"]:
+                state["moods"][name] = random.choice([
+                    "happy", "stressed", "bored", "excited", "hungry",
+                    "tired", "nostalgic", "curious", "proud", "embarrassed",
+                ])
+            if name not in state["reflections"]:
+                state["reflections"][name] = ""
+            if name not in state["positions"]:
+                state["positions"][name] = c.get("home", "square")
+            if name not in state["activities"]:
+                state["activities"][name] = "starting the day"
+            if not state["timeline"][name]:
+                state["timeline"][name].append(f"{format_time(state['game_time'])} at {state['positions'][name].replace('_', ' ')}")
+        pairs = [(a["name"], b["name"]) for a in world["cast"] for b in world["cast"] if a["name"] < b["name"]]
+        for a, b in pairs:
+            if (a, b) not in state["affinity"]:
+                state["affinity"][(a, b)] = 0.0
+
+
+def get_mood(world_id, name):
+    state = get_state(world_id)
+    with _lock:
+        return state["moods"].get(name, "curious")
+
+
+def set_mood(world_id, name, mood):
+    state = get_state(world_id)
+    with _lock:
+        state["moods"][name] = mood
+
+
+def get_memory(world_id, name):
+    state = get_state(world_id)
+    with _lock:
+        return list(state["memory"][name])
+
+
+def add_memory(world_id, name, event, reaction_text):
+    state = get_state(world_id)
+    entry = f"Event: {event} | Reaction: {reaction_text}"
+    with _lock:
+        state["memory"][name].append(entry)
+
+
+def add_gossip(world_id, target_name, snippet):
+    state = get_state(world_id)
+    entry = f"Gossip: {snippet}"
+    with _lock:
+        state["memory"][target_name].append(entry)
+
+
+def get_reflection(world_id, name):
+    state = get_state(world_id)
+    with _lock:
+        return state["reflections"].get(name, "")
+
+
+def set_reflection(world_id, name, text):
+    state = get_state(world_id)
+    with _lock:
+        state["reflections"][name] = text
+
+
+def get_vibes(world_id):
+    state = get_state(world_id)
+    with _lock:
+        return dict(state["vibes"])
+
+
+def get_affinity(world_id):
+    state = get_state(world_id)
+    with _lock:
+        return dict(state["affinity"])
+
+
+def get_position(world_id, name):
+    state = get_state(world_id)
+    with _lock:
+        return state["positions"].get(name)
+
+
+def set_position(world_id, name, hotspot):
+    state = get_state(world_id)
+    with _lock:
+        state["positions"][name] = hotspot
+
+
+def get_needs(world_id):
+    state = get_state(world_id)
+    with _lock:
+        return {name: vals.copy() for name, vals in state["needs"].items()}
+
+
+def get_activity(world_id, name):
+    state = get_state(world_id)
+    with _lock:
+        return state["activities"].get(name, "")
+
+
+def get_timeline(world_id):
+    state = get_state(world_id)
+    with _lock:
+        return {name: list(entries) for name, entries in state["timeline"].items()}
+
+
+def get_game_time(world_id):
+    state = get_state(world_id)
+    with _lock:
+        return state["day"], state["game_time"], state["paused"]
+
+
+def set_paused(world_id, paused):
+    state = get_state(world_id)
+    with _lock:
+        state["paused"] = bool(paused)
+        return state["paused"]
+
+
+def apply_vibe_delta(world_id, name, delta):
+    state = get_state(world_id)
+    with _lock:
+        v = state["vibes"].setdefault(name, {"energy": 0.5, "social": 0.5})
+        v["energy"] = max(0.0, min(1.0, v["energy"] + delta.get("energy", 0)))
+        v["social"] = max(0.0, min(1.0, v["social"] + delta.get("social", 0)))
+
+
+def apply_affinity_delta(world_id, name, delta):
+    state = get_state(world_id)
+    with _lock:
+        for other, d in delta.items():
+            pair = tuple(sorted([name, other]))
+            state["affinity"][pair] = max(-1.0, min(1.0, state["affinity"].get(pair, 0.0) + d))
+
+
+def increment_event(world_id, chaos_delta=0.1):
+    state = get_state(world_id)
+    with _lock:
+        state["event_count"] += 1
+        state["chaos"] = min(1.0, state["chaos"] + chaos_delta)
+        if state["event_count"] % 5 == 0:
+            state["day"] += 1
+
+
+def tick(world, hours=1.0, force=False):
+    state = get_state(world["id"])
+    with _lock:
+        if state["paused"] and not force:
+            return False
+        previous_hour = state["game_time"]
+        state["game_time"] += hours
+        while state["game_time"] >= 24:
+            state["game_time"] -= 24
+            state["day"] += 1
+        for c in world["cast"]:
+            name = c["name"]
+            entry = schedule_entry(c, state["game_time"])
+            if not entry:
+                continue
+            _, _, hotspot, activity, effects = entry
+            if hotspot not in (world.get("board", {}) or {}).get("hotspots_tile", {}):
+                hotspot = c.get("home", "square")
+            old_pos = state["positions"].get(name)
+            old_activity = state["activities"].get(name)
+            state["positions"][name] = hotspot
+            state["activities"][name] = activity
+            needs = state["needs"].setdefault(name, {"energy": 60, "hunger": 35, "social": 50})
+            needs["hunger"] = _clamp_need(needs.get("hunger", 35) + 4 + effects.get("hunger", 0))
+            needs["energy"] = _clamp_need(needs.get("energy", 60) + effects.get("energy", 0))
+            needs["social"] = _clamp_need(needs.get("social", 50) + effects.get("social", 0))
+            if old_pos != hotspot or old_activity != activity or int(previous_hour) != int(state["game_time"]):
+                state["timeline"][name].append(
+                    f"{format_time(state['game_time'])} -> {hotspot.replace('_', ' ')} ({activity})"
+                )
+        return True
+
+
+def schedule_entry(character, hour):
+    schedule = character.get("schedule") or DEFAULT_SCHEDULES.get(character_role(character), [])
+    for entry in schedule:
+        start, end = entry[0], entry[1]
+        if start <= end:
+            active = start <= hour < end
+        else:
+            active = hour >= start or hour < end
+        if active:
+            return entry
+    home = character.get("home", "square")
+    return [0, 24, home, "at home", {"energy": 0, "hunger": 0, "social": 0}]
+
+
+def character_role(character):
+    role = character.get("role")
+    if role:
+        return role
+    job = character.get("job", "").lower()
+    if "student" in job:
+        return "student"
+    if "paramedic" in job or "nurse" in job or "medic" in job:
+        return "medic"
+    if "retired" in job:
+        return "retiree"
+    if "cafe" in job or "shop" in job or "owner" in job:
+        return "shopkeeper"
+    return "worker"
+
+
+def format_time(hour):
+    hour = hour % 24
+    h = int(hour)
+    m = int(round((hour - h) * 60)) % 60
+    return f"{h:02d}:{m:02d}"
+
+
+def _clamp_need(value):
+    return max(0, min(100, int(value)))
+
+
+def get_town_mood(world_id):
+    state = get_state(world_id)
+    with _lock:
+        return state["town_mood"]
+
+
+def set_town_mood(world_id, val):
+    state = get_state(world_id)
+    with _lock:
+        state["town_mood"] = max(-1.0, min(1.0, val))
+
+
+def get_event_count(world_id):
+    state = get_state(world_id)
+    with _lock:
+        return state["event_count"]
+
+
+def get_day(world_id):
+    state = get_state(world_id)
+    with _lock:
+        return state["day"]
+
+
+def get_chaos(world_id):
+    state = get_state(world_id)
+    with _lock:
+        return state["chaos"]
+
+
+def get_campaign(world_id):
+    """A copy of the campaign state (mutable containers copied so callers can't
+    corrupt the locked state by accident)."""
+    state = get_state(world_id)
+    with _lock:
+        c = state["campaign"]
+        snap = dict(c)
+        snap["crisis_met"] = set(c["crisis_met"])
+        snap["clues"] = list(c["clues"])
+        snap["chapter_grades"] = [dict(g) for g in c["chapter_grades"]]
+        snap["mvp_tally"] = dict(c["mvp_tally"])
+        return snap
+
+
+def campaign_update(world_id, **fields):
+    """Merge fields into the campaign state under the lock."""
+    state = get_state(world_id)
+    with _lock:
+        state["campaign"].update(fields)
+        return dict(state["campaign"])
+
+
+def reset_campaign(world_id):
+    state = get_state(world_id)
+    with _lock:
+        state["campaign"] = _new_campaign()
+        return dict(state["campaign"])
+
+
+def add_chaos(world_id, delta):
+    state = get_state(world_id)
+    with _lock:
+        state["chaos"] = max(0.0, min(1.0, state["chaos"] + delta))
+        return state["chaos"]
+
+
+def reset_chaos(world_id):
+    state = get_state(world_id)
+    with _lock:
+        state["chaos"] = 0.0
+
+
+def maybe_form_reflection(world_id, name):
+    state = get_state(world_id)
+    with _lock:
+        memories = list(state["memory"][name])
+        if not memories:
+            return
+        last = memories[-1]
+        learned = last.split("| Reaction:")[-1].strip() if "| Reaction:" in last else last
+        learned = learned.rstrip(".")
+        templates = [
+            f"I'm learning how this block reacts. Last time, my move was to {learned.lower()}.",
+            f"Each thing that happens teaches me something. I keep choosing to act, not just watch.",
+            f"I remember what I did last time, and I'd do it again: {learned}.",
+            f"These events are changing how I read my neighbors — and myself.",
+            f"I trust my instincts more now. {learned} felt right.",
+        ]
+        state["reflections"][name] = random.choice(templates)

worlds/__init__.py

@@ -0,0 +1,18 @@
+from worlds.maple_street import WORLD as MAPLE_STREET
+from worlds.riverside_campus import WORLD as RIVERSIDE_CAMPUS
+
+WORLDS = {
+    "maple_street": MAPLE_STREET,
+    "riverside_campus": RIVERSIDE_CAMPUS,
+}
+
+
+def get_world(world_id):
+    return WORLDS.get(world_id)
+
+
+def list_worlds():
+    return [
+        {"id": wid, "name": w["name"], "theme": w["theme"]}
+        for wid, w in WORLDS.items()
+    ]

worlds/maple_street.py

@@ -0,0 +1,542 @@
+WORLD = {
+    "id": "maple_street",
+    "name": "Maple Street",
+    "theme": "cozy modern suburb",
+    "diorama": "assets/worlds/maple_street.png",
+    "palette": {
+        "bg": "#0b0f1a",
+        "grass": "#1a4a2a",
+        "road": "#1e2235",
+        "house": "#c45b5b",
+        "park": "#0a3a2a",
+        "tree": "#0a2a1a",
+        "sky": "#0a0f1a",
+        "tint_day": "#fff3d6",
+        "tint_night": "#1a2342",
+    },
+    "hotspots": {
+        "marta_home": [17, 63],
+        "cafe": [72, 58],
+        "park": [58, 50],
+        "square": [48, 73],
+        "jay_home": [89, 87],
+        "school": [37, 56],
+        "nia_clinic": [13, 81],
+        "priya_office": [82, 78],
+    },
+    "scenery": {
+        "buildings": [
+            {"left": 5,  "top": 40, "w": 15, "h": 15, "front": "#3a2b4d", "roof": "#ff5fa2", "side": "#241a33", "label": "🕰️"},
+            {"left": 27, "top": 33, "w": 20, "h": 14, "front": "#23314f", "roof": "#38e8ff", "side": "#16213a", "label": "🏫"},
+            {"left": 63, "top": 36, "w": 17, "h": 14, "front": "#4a3b2b", "roof": "#ffd76a", "side": "#33291d", "label": "☕"},
+            {"left": 3,  "top": 61, "w": 14, "h": 14, "front": "#1f3d3a", "roof": "#7CFFB2", "side": "#142826", "label": "🚑"},
+            {"left": 71, "top": 53, "w": 16, "h": 17, "front": "#2c2b4d", "roof": "#9b6bff", "side": "#1d1c33", "label": "🏢"},
+            {"left": 82, "top": 69, "w": 14, "h": 12, "front": "#3a2030", "roof": "#ff8a5f", "side": "#281622", "label": "🏪"},
+        ],
+        "roads": [
+            {"left": -5, "top": 66, "w": 120, "h": 9,  "rot": -8},
+            {"left": 40, "top": 30, "w": 9,  "h": 70, "rot": 6},
+        ],
+        "trees": [
+            {"left": 21, "top": 52, "s": 1.0},
+            {"left": 52, "top": 46, "s": 0.8},
+            {"left": 62, "top": 66, "s": 1.1},
+            {"left": 33, "top": 80, "s": 0.9},
+            {"left": 94, "top": 52, "s": 0.8},
+        ],
+        "props": [
+            {"left": 49, "top": 64, "emoji": "⛲"},
+            {"left": 30, "top": 67, "emoji": "🪧"},
+        ],
+    },
+    "cast": [
+        {
+            "name": "Marta Voss",
+            "age": 68,
+            "job": "retired watchmaker",
+            "traits": ["blunt", "observant", "nostalgic"],
+            "backstory": "She ran the neighborhood clock shop for four decades and still notices every tiny change on the street.",
+            "relationships": {
+                "Jay Park": "rival",
+                "Nia Okafor": "friend",
+                "Luca Bell": "family",
+                "Priya Raman": "friend",
+            },
+            "voice_description": "(a grumpy elderly woman, deep measured low-pitched voice)",
+            "model": "nvidia/Nemotron-Mini-4B-Instruct",
+            "emoji": "🧓",
+            "home": "marta_home",
+            "catchphrase_hint": "always compares things to the past",
+        },
+        {
+            "name": "Jay Park",
+            "age": 24,
+            "job": "food delivery cyclist",
+            "traits": ["restless", "funny", "impulsive"],
+            "backstory": "He knows every shortcut in the district and treats ordinary afternoons like they might become legends.",
+            "relationships": {
+                "Marta Voss": "rival",
+                "Nia Okafor": "crush",
+                "Luca Bell": "friend",
+                "Priya Raman": "friend",
+            },
+            "voice_description": "(an energetic young man, quick bright mid-pitched voice)",
+            "model": "nvidia/Nemotron-Mini-4B-Instruct",
+            "emoji": "🚴",
+            "home": "jay_home",
+            "catchphrase_hint": "turns everything into an adventure",
+        },
+        {
+            "name": "Nia Okafor",
+            "age": 35,
+            "job": "paramedic",
+            "traits": ["calm", "protective", "dry-witted"],
+            "backstory": "After years on emergency shifts, she reads chaos quickly and trusts people more than they expect.",
+            "relationships": {
+                "Marta Voss": "friend",
+                "Jay Park": "crush",
+                "Luca Bell": "friend",
+                "Priya Raman": "family",
+            },
+            "voice_description": "(a steady adult woman, warm confident medium-low voice)",
+            "model": "nvidia/Nemotron-Mini-4B-Instruct",
+            "emoji": "🚑",
+            "home": "nia_clinic",
+            "catchphrase_hint": "downplays danger but always steps up",
+        },
+        {
+            "name": "Luca Bell",
+            "age": 15,
+            "job": "student and arcade regular",
+            "traits": ["curious", "dramatic", "inventive"],
+            "backstory": "He documents neighborhood rumors in a battered notebook and is convinced something world-changing will happen here first.",
+            "relationships": {
+                "Marta Voss": "family",
+                "Jay Park": "friend",
+                "Nia Okafor": "friend",
+                "Priya Raman": "rival",
+            },
+            "voice_description": "(a teenage boy, eager expressive slightly high-pitched voice)",
+            "model": "nvidia/Nemotron-Mini-4B-Instruct",
+            "emoji": "🧒",
+            "home": "school",
+            "catchphrase_hint": "treats everything like breaking news",
+        },
+        {
+            "name": "Priya Raman",
+            "age": 42,
+            "job": "city planner",
+            "traits": ["organized", "skeptical", "secretly romantic"],
+            "backstory": "She came to fix the block's chronic little problems and keeps getting pulled into everyone else's dramas.",
+            "relationships": {
+                "Marta Voss": "friend",
+                "Jay Park": "friend",
+                "Nia Okafor": "family",
+                "Luca Bell": "rival",
+            },
+            "voice_description": "(a precise middle-aged woman, crisp thoughtful medium voice)",
+            "model": "nvidia/Nemotron-Mini-4B-Instruct",
+            "emoji": "👩‍💼",
+            "home": "priya_office",
+            "catchphrase_hint": "tries to stay logical but feelings leak through",
+        },
+    ],
+    "board": {
+        # A real residential street: a suburban grid of homes with a small high street,
+        # a school, a clinic and a park. Deliberately NOT the same shape as the other worlds.
+        "cols": 22,
+        "rows": 18,
+        "ambient": 6,
+        "roads": {"cols": [5, 11, 17], "rows": [6, 13]},
+        "plaza": [[12, 9], [13, 9], [12, 10], [13, 10]],
+        "plaza_center": [12.5, 9.5],
+        "buildings": [
+            # homes — pitched-roof houses in warm, lived-in colours (most of a neighborhood is houses)
+            {"gx": 1,  "gy": 1,  "w": 2, "d": 2, "h": 24, "kind": "house", "wall": "#caa074", "roof": "#8a3b2e", "label": "MARTA"},
+            {"gx": 8,  "gy": 1,  "w": 2, "d": 2, "h": 24, "kind": "house", "wall": "#b6c081", "roof": "#4a6b32", "label": "THE PARKS"},
+            {"gx": 19, "gy": 1,  "w": 2, "d": 2, "h": 26, "kind": "house", "wall": "#b79ec0", "roof": "#5a3b6b", "label": "RAMAN"},
+            {"gx": 1,  "gy": 15, "w": 2, "d": 2, "h": 24, "kind": "house", "wall": "#c79a78", "roof": "#7a4a2e", "label": "No. 12"},
+            {"gx": 15, "gy": 15, "w": 2, "d": 2, "h": 24, "kind": "house", "wall": "#9ab0c0", "roof": "#3b5a6b", "label": "No. 9"},
+            {"gx": 19, "gy": 9,  "w": 2, "d": 2, "h": 24, "kind": "house", "wall": "#c0a86a", "roof": "#6b5a2e", "label": "No. 7"},
+            # the little high street — a café and a corner store with real storefronts
+            {"gx": 14, "gy": 1,  "w": 2, "d": 2, "h": 30, "kind": "shop",  "wall": "#8a6f3f", "roof": "#ff8a5f", "label": "CAFÉ"},
+            {"gx": 1,  "gy": 8,  "w": 2, "d": 2, "h": 28, "kind": "shop",  "wall": "#6f5a8a", "roof": "#38e8ff", "label": "CORNER STORE"},
+            # civic — a small school and a clinic
+            {"gx": 8,  "gy": 15, "w": 3, "d": 2, "h": 34, "kind": "block", "wall": "#6a6f8a", "roof": "#ffd76a", "label": "SCHOOL"},
+            {"gx": 19, "gy": 15, "w": 2, "d": 2, "h": 30, "kind": "block", "wall": "#4f8576", "roof": "#7CFFB2", "label": "CLINIC"},
+        ],
+        "trees": [
+            [9, 11], [10, 12], [7, 4], [16, 4], [4, 10], [20, 12], [7, 16], [12, 16], [18, 6], [6, 7],
+        ],
+        "props": [
+            {"type": "fountain", "gx": 12, "gy": 12},
+            {"type": "pond", "gx": 15, "gy": 11, "w": 2, "d": 2},
+            {"type": "bench", "gx": 10, "gy": 11},
+            {"type": "bench", "gx": 14, "gy": 12},
+            # café seating on the high street
+            {"type": "table", "gx": 13, "gy": 3},
+            {"type": "table", "gx": 16, "gy": 3},
+            # corner-store produce stall
+            {"type": "stall", "gx": 3, "gy": 9, "color": "#caa23f"},
+            # greenery + lamps to make it feel lived-in
+            {"type": "planter", "gx": 7, "gy": 12},
+            {"type": "planter", "gx": 12, "gy": 7},
+            {"type": "lamp", "gx": 11, "gy": 8},
+            {"type": "lamp", "gx": 14, "gy": 8},
+            {"type": "lamp", "gx": 5, "gy": 12},
+        ],
+        "hotspots_tile": {
+            "marta_home": [3, 2],
+            "jay_home": [8, 3],
+            "priya_office": [18, 2],
+            "school": [10, 14],
+            "nia_clinic": [18, 15],
+            "cafe": [14, 4],
+            "shop": [3, 8],
+            "park": [10, 11],
+            "fountain": [11, 12],
+            "square": [13, 10],
+        },
+        # where each character goes (and what they do) when an event hits — spread out,
+        # in-character, so the street reads like a real place reacting, not a mob.
+        "activities": {
+            "Marta Voss":  {"tile": [10, 11], "label": "🪑 watches from the park bench"},
+            "Jay Park":    {"tile": [14, 4],  "label": "🚴 races to the café", "vehicle": "bike"},
+            "Nia Okafor":  {"tile": [18, 15], "label": "🚑 heads to the clinic"},
+            "Luca Bell":   {"tile": [11, 12], "label": "🔎 investigates the fountain"},
+            "Priya Raman": {"tile": [18, 2],  "label": "🏠 hurries home to plan"},
+        },
+    },
+    "scenarios": [
+        {
+            "id": "school_closing",
+            "title": "The school will be closed by the city",
+            "event": "The city announces Maple Street Elementary will be shut down at the end of the semester due to budget cuts.",
+            "focus": "How do different generations react to losing a community institution?",
+        },
+        {
+            "id": "new_neighbor",
+            "title": "A new family moves in next door",
+            "event": "A young family with two kids moves into the empty house on Maple Street. They seem nice but awfully quiet.",
+            "focus": "How does the neighborhood welcome (or distrust) newcomers?",
+        },
+        {
+            "id": "park_renovation",
+            "title": "The park gets a makeover",
+            "event": "The city approves a full renovation of the tiny park on Maple Street. Construction starts Monday.",
+            "focus": "Who benefits from change and who loses something familiar?",
+        },
+        {
+            "id": "power_outage",
+            "title": "A summer power outage hits the block",
+            "event": "A heatwave knocks out power to the entire block for an estimated six hours. No AC, no lights, no screens.",
+            "focus": "How do people cope when their routines are stripped away?",
+        },
+    ],
+    "events": [
+        "A mysterious glowing object lands in the park",
+        "The power goes out across the entire neighborhood",
+        "A stray cat starts following people around town",
+        "Someone paints a giant mural on the side of the corner store",
+        "A food truck rolls in and parks in the middle of the square",
+        "The old clock tower starts chiming at random hours",
+        "A thunderstorm knocks down the biggest tree on Maple Street",
+        "Someone leaves a box of kittens on the church doorstep",
+        "The neighborhood gets its own Wikipedia page overnight",
+        "A film crew shows up to shoot a commercial on the block",
+    ],
+    # ---- Crisis Mode content -------------------------------------------------
+    # Each crisis declares the concrete responses that count as "handling it".
+    # The resolver (crisis.py) checks the residents' goto + action against these.
+    "crises": [
+        {
+            "id": "cafe_fire",
+            "title": "Kitchen fire at the café",
+            "narrative": "Smoke is pouring out of the café on the high street — a grease fire has caught in the kitchen and it's spreading fast.",
+            "severity": 3,
+            "kind": "fire",
+            "affected_hotspot": "cafe",
+            "time_limit": 4,
+            "escalation": "The flames are climbing toward the upstairs flats.",
+            "focus": "When the same emergency hits, who runs toward it, who organizes, and who freezes?",
+            "success_text": "The fire's out, everyone's accounted for, and the café will reopen.",
+            "failure_text": "The café is gutted and the block is shaken.",
+            "requirements": [
+                {
+                    "id": "containment",
+                    "label": "🔥 Contain the fire",
+                    "hotspots": ["cafe"],
+                    "action_keywords": [
+                        "fire", "flame", "douse", "extinguish", "put out",
+                        "water", "smoke", "hose", "blanket",
+                    ],
+                    "weight": 1.5,
+                },
+                {
+                    "id": "medical",
+                    "label": "🚑 Get medical on scene",
+                    "hotspots": ["cafe", "nia_clinic"],
+                    "action_keywords": [
+                        "help", "treat", "check", "injur", "hurt", "burn",
+                        "aid", "care", "first aid", "ambulance",
+                    ],
+                    "role": "medic",
+                    "weight": 1.0,
+                },
+                {
+                    "id": "evacuation",
+                    "label": "🏃 Evacuate the building",
+                    "hotspots": ["cafe", "square"],
+                    "action_keywords": [
+                        "evacuat", "get everyone out", "clear", "warn",
+                        "usher", "people out", "safe", "away",
+                    ],
+                    "weight": 1.0,
+                },
+                {
+                    "id": "coordination",
+                    "label": "📋 Coordinate the response",
+                    "hotspots": ["priya_office", "square"],
+                    "action_keywords": [
+                        "coordinat", "organi", "plan", "call", "rally",
+                        "manage", "direct", "report", "emergency",
+                    ],
+                    "role": "worker",
+                    "weight": 1.0,
+                    "optional": True,
+                },
+            ],
+        },
+        {
+            "id": "heatwave_blackout",
+            "title": "Heatwave blackout",
+            "narrative": "A record heatwave has knocked out power to the whole block — no AC, no fans, and the elderly are sweltering in their flats.",
+            "severity": 3,
+            "kind": "blackout",
+            "affected_hotspot": "priya_office",
+            "time_limit": 4,
+            "escalation": "It's getting dangerously hot indoors.",
+            "focus": "In a slow-burning emergency with no obvious villain, who takes initiative and who waits?",
+            "success_text": "Power's restored, the vulnerable were looked after, and the block cooled down.",
+            "failure_text": "People suffered through the heat with no one taking charge.",
+            "requirements": [
+                {
+                    "id": "restore",
+                    "label": "⚡ Get the power back",
+                    "hotspots": ["priya_office"],
+                    "action_keywords": ["power", "grid", "restore", "electric", "generator", "call", "utility", "fix"],
+                    "role": "worker",
+                    "weight": 1.5,
+                },
+                {
+                    "id": "welfare",
+                    "label": "🚑 Check on the vulnerable",
+                    "hotspots": ["marta_home", "nia_clinic", "square"],
+                    "action_keywords": ["check", "elderly", "vulnerable", "welfare", "water", "cool", "help", "care"],
+                    "role": "medic",
+                    "weight": 1.0,
+                },
+                {
+                    "id": "coordination",
+                    "label": "📋 Organize a cooling shelter",
+                    "hotspots": ["square", "priya_office"],
+                    "action_keywords": ["organi", "plan", "coordinat", "shelter", "gather", "rally"],
+                    "weight": 1.0,
+                },
+                {
+                    "id": "relief",
+                    "label": "💧 Hand out water & shade",
+                    "hotspots": ["cafe", "square"],
+                    "action_keywords": ["water", "cool", "shade", "drinks", "ice", "relief"],
+                    "weight": 1.0,
+                    "optional": True,
+                },
+            ],
+        },
+        {
+            "id": "storm_tree",
+            "title": "Storm downs the big maple",
+            "narrative": "A violent summer storm has torn down the giant maple in the park — and someone is trapped under the branches.",
+            "severity": 4,
+            "kind": "storm",
+            "affected_hotspot": "park",
+            "time_limit": 4,
+            "escalation": "The trapped neighbor is hurt and the rain is still coming down.",
+            "focus": "Under real physical danger, who acts on instinct and who needs a plan first?",
+            "success_text": "They freed the trapped neighbor and got everyone to safety.",
+            "failure_text": "Help came too slow and the night turned grim.",
+            "requirements": [
+                {
+                    "id": "rescue",
+                    "label": "🌳 Free the trapped neighbor",
+                    "hotspots": ["park"],
+                    "action_keywords": ["lift", "free", "rescue", "trapped", "move", "clear", "branch", "pull", "dig"],
+                    "weight": 1.5,
+                },
+                {
+                    "id": "medical",
+                    "label": "🚑 Treat the injured",
+                    "hotspots": ["park", "nia_clinic"],
+                    "action_keywords": ["treat", "help", "injur", "aid", "first aid", "hurt", "care", "bandage"],
+                    "role": "medic",
+                    "weight": 1.0,
+                },
+                {
+                    "id": "safety",
+                    "label": "🚧 Secure the area",
+                    "hotspots": ["park", "square"],
+                    "action_keywords": ["clear", "warn", "safe", "away", "cordon", "keep back", "secure"],
+                    "weight": 1.0,
+                },
+                {
+                    "id": "coordination",
+                    "label": "📋 Call for help",
+                    "hotspots": ["priya_office", "square"],
+                    "action_keywords": ["coordinat", "plan", "call", "report", "organi", "emergency"],
+                    "role": "worker",
+                    "weight": 1.0,
+                    "optional": True,
+                },
+            ],
+        },
+        {
+            "id": "missing_child",
+            "title": "A child goes missing",
+            "narrative": "In all the chaos, a little one has wandered off — nobody has seen them for an hour and it's getting dark.",
+            "severity": 4,
+            "kind": "search",
+            "affected_hotspot": "square",
+            "time_limit": 4,
+            "escalation": "Night is falling and the search is getting harder.",
+            "focus": "When the task needs everyone spread out, who organizes the search and who just runs?",
+            "success_text": "They found the child safe — a whole block searching together.",
+            "failure_text": "The search stayed scattered and frightened.",
+            "requirements": [
+                {
+                    "id": "search_park",
+                    "label": "🔦 Search the park",
+                    "hotspots": ["park"],
+                    "action_keywords": ["search", "look", "find", "check", "comb", "scour"],
+                    "weight": 1.0,
+                },
+                {
+                    "id": "search_school",
+                    "label": "🔦 Search the school",
+                    "hotspots": ["school"],
+                    "action_keywords": ["search", "look", "find", "check", "comb", "scour"],
+                    "weight": 1.0,
+                },
+                {
+                    "id": "coordination",
+                    "label": "📋 Organize the search",
+                    "hotspots": ["square", "priya_office"],
+                    "action_keywords": ["organi", "coordinat", "plan", "split up", "call", "rally", "direct"],
+                    "weight": 1.0,
+                },
+                {
+                    "id": "reassure",
+                    "label": "🫂 Reassure the family",
+                    "hotspots": ["square", "marta_home"],
+                    "action_keywords": ["calm", "reassure", "comfort", "stay", "with the family"],
+                    "weight": 1.0,
+                    "optional": True,
+                },
+            ],
+        },
+        {
+            "id": "everything_at_once",
+            "title": "The town comes apart",
+            "narrative": "It's all happening at once — a fire on the high street, the power failing, and panic spreading through the square. This is no accident.",
+            "severity": 5,
+            "kind": "fire",
+            "affected_hotspot": "square",
+            "time_limit": 5,
+            "escalation": "Everything that can go wrong is going wrong together.",
+            "focus": "When everything fails at once, does the town fall apart or pull together?",
+            "success_text": "Against the odds, the block held — every person did their part.",
+            "failure_text": "It was too much, all at once.",
+            "requirements": [
+                {
+                    "id": "containment",
+                    "label": "🔥 Contain the fire",
+                    "hotspots": ["cafe"],
+                    "action_keywords": ["fire", "flame", "douse", "extinguish", "put out", "water", "smoke"],
+                    "weight": 1.5,
+                },
+                {
+                    "id": "restore",
+                    "label": "⚡ Restore the power",
+                    "hotspots": ["priya_office"],
+                    "action_keywords": ["power", "grid", "restore", "electric", "generator", "call", "fix"],
+                    "role": "worker",
+                    "weight": 1.0,
+                },
+                {
+                    "id": "medical",
+                    "label": "🚑 Tend the hurt",
+                    "hotspots": ["cafe", "square", "nia_clinic"],
+                    "action_keywords": ["treat", "help", "injur", "aid", "first aid", "hurt", "care"],
+                    "role": "medic",
+                    "weight": 1.0,
+                },
+                {
+                    "id": "evacuation",
+                    "label": "🏃 Calm the square",
+                    "hotspots": ["square"],
+                    "action_keywords": ["evacuat", "calm", "clear", "warn", "safe", "away", "usher", "people out"],
+                    "weight": 1.0,
+                },
+            ],
+        },
+    ],
+    "campaign": {
+        "id": "long_summer",
+        "title": "Season 1 · The Long Summer",
+        "chapters": [
+            {
+                "id": "ch1",
+                "crisis_id": "cafe_fire",
+                "intro": "A hot, ordinary afternoon on Maple Street. Then smoke starts rising from the café…",
+                "outro_win": "The fire's out. People hug on the pavement. 'Could've been so much worse,' someone says.",
+                "outro_loss": "The café smolders. Nobody quite knows how it got so bad so fast.",
+                "clue": "Nia notices the fire started right after the gas line was 'serviced' this morning. Odd.",
+            },
+            {
+                "id": "ch2",
+                "crisis_id": "heatwave_blackout",
+                "intro": "A week later, the hottest day on record — and then every light on the block goes dark at once.",
+                "outro_win": "The fans whir back to life. Marta mutters that nothing on this street is a coincidence anymore.",
+                "outro_loss": "A long, sweltering night. People start asking why this keeps happening here.",
+                "clue": "Priya checks the grid logs: the outage was triggered manually, from outside the neighborhood.",
+            },
+            {
+                "id": "ch3",
+                "crisis_id": "storm_tree",
+                "intro": "The forecast promised clear skies. The storm that hits the park was nowhere on the radar.",
+                "outro_win": "Soaked and shaking, they carry their neighbor to safety. 'Who's doing this to us?'",
+                "outro_loss": "A hard night under the fallen maple. The block feels watched.",
+                "clue": "Luca's notebook: every disaster has hit a different corner of Maple Street, in order, like a map.",
+            },
+            {
+                "id": "ch4",
+                "crisis_id": "missing_child",
+                "intro": "Fear has settled over the block. And now, in the middle of it, a child is gone.",
+                "outro_win": "The child is found, safe. The relief is enormous — but so is the dread.",
+                "outro_loss": "The search drags on into the dark. The town has never felt so alone.",
+                "clue": "The child says a 'nice voice on the speaker' told them where to go. Someone is steering all of this.",
+            },
+            {
+                "id": "ch5",
+                "crisis_id": "everything_at_once",
+                "intro": "Then it all comes at once — fire, blackout, panic. The town finally understands: none of it was an accident.",
+                "outro_win": "Battered but unbroken, the five of them stand in the square. They made it through. Together.",
+                "outro_loss": "The Long Summer breaks the block. But they'll remember who they were to each other.",
+                "clue": "The pieces fit. There was always a hand behind the chaos.",
+            },
+        ],
+        "finale_reveal": (
+            "Every fire, every blackout, every storm — traced back to one source. "
+            "The one who threw each event at the town. The one at the controls. You."
+        ),
+    },
+}

worlds/riverside_campus.py

@@ -0,0 +1,130 @@
+_M = "nvidia/Nemotron-Mini-4B-Instruct"
+
+WORLD = {
+    "id": "riverside_campus",
+    "name": "Riverside Campus",
+    "theme": "school-town campus beside a river",
+    "palette": {"bg": "#071018", "grass": "#214b36", "road": "#253044"},
+    "board": {
+        "cols": 24,
+        "rows": 16,
+        "ambient": 10,
+        "roads": {"cols": [3, 18], "rows": [4, 11]},
+        "plaza": [[10, 7], [11, 7], [12, 7], [10, 8], [11, 8], [12, 8]],
+        "plaza_center": [11, 7.5],
+        "buildings": [
+            {"gx": 6,  "gy": 1,  "w": 4, "d": 2, "h": 38, "kind": "block", "wall": "#7a7257", "roof": "#ffd76a", "label": "SCHOOL"},
+            {"gx": 12, "gy": 1,  "w": 3, "d": 2, "h": 32, "kind": "block", "wall": "#5e7779", "roof": "#38e8ff", "label": "SCIENCE"},
+            {"gx": 20, "gy": 1,  "w": 2, "d": 2, "h": 26, "kind": "house", "wall": "#9b8663", "roof": "#7a4a2e", "label": "GROUNDS"},
+            {"gx": 5,  "gy": 6,  "w": 2, "d": 2, "h": 28, "kind": "shop",  "wall": "#8a6b50", "roof": "#ff8a5f", "label": "RIVER CAFÉ"},
+            {"gx": 16, "gy": 6,  "w": 2, "d": 2, "h": 30, "kind": "block", "wall": "#5a8a7d", "roof": "#7CFFB2", "label": "NURSE"},
+            {"gx": 8,  "gy": 13, "w": 3, "d": 2, "h": 24, "kind": "house", "wall": "#8a789b", "roof": "#9b6bff", "label": "DORMS"},
+            {"gx": 14, "gy": 13, "w": 3, "d": 2, "h": 24, "kind": "house", "wall": "#7f9a72", "roof": "#4a6b32", "label": "FAMILY HALL"},
+        ],
+        "trees": [[2, 2], [4, 2], [5, 10], [8, 9], [13, 10], [16, 10], [20, 9], [21, 13], [6, 14], [2, 13]],
+        "props": [
+            {"type": "pond", "gx": 21, "gy": 5, "w": 2, "d": 6},
+            {"type": "fountain", "gx": 11, "gy": 8},
+            {"type": "bench", "gx": 9, "gy": 7},
+            {"type": "bench", "gx": 13, "gy": 8},
+            {"type": "table", "gx": 7, "gy": 8},
+            {"type": "table", "gx": 5, "gy": 9},
+            {"type": "lamp", "gx": 10, "gy": 6},
+            {"type": "lamp", "gx": 14, "gy": 6},
+            {"type": "planter", "gx": 12, "gy": 10},
+        ],
+        "hotspots_tile": {
+            "school": [8, 3],
+            "science_lab": [13, 3],
+            "grounds_shed": [20, 3],
+            "cafe": [6, 8],
+            "nurse_office": [16, 8],
+            "quad": [11, 7],
+            "library_steps": [12, 10],
+            "riverside_walk": [20, 11],
+            "dorms": [9, 12],
+            "family_hall": [15, 12],
+            "square": [9, 8],
+            "park": [14, 10],
+        },
+        "activities": {
+            "Elena Brooks": {"tile": [8, 3], "label": "teaches in the classroom"},
+            "Samir Patel": {"tile": [13, 3], "label": "checks the science lab"},
+            "Maya Chen": {"tile": [11, 7], "label": "sketches on the quad"},
+            "Rosa Alvarez": {"tile": [6, 8], "label": "runs the café counter"},
+            "Talia Reed": {"tile": [16, 8], "label": "keeps the nurse office ready"},
+            "Owen Moss": {"tile": [20, 11], "label": "walks the riverside grounds"},
+        },
+    },
+    "cast": [
+        {
+            "name": "Elena Brooks", "age": 39, "job": "history teacher", "role": "worker",
+            "traits": ["patient", "principled", "quietly funny"],
+            "backstory": "She grew up nearby and came back to teach because the campus gave her a future.",
+            "relationships": {"Samir Patel": "mentor", "Maya Chen": "mentor", "Rosa Alvarez": "friend", "Talia Reed": "friend", "Owen Moss": "ally"},
+            "voice_description": "(a calm adult woman, clear warm teacherly voice)", "model": _M,
+            "emoji": "👩‍🏫", "home": "school", "catchphrase_hint": "turns trouble into a lesson",
+            "schedule": [[7, 8, "cafe", "coffee before homeroom", {"hunger": -8, "energy": 2}], [8, 15, "school", "teaching classes", {"energy": -10, "social": 8}], [15, 17, "library_steps", "grading on the steps", {"energy": -3}], [17, 22, "family_hall", "calling families and planning", {"energy": -4, "social": 2}], [22, 7, "family_hall", "resting", {"energy": 25}]],
+        },
+        {
+            "name": "Samir Patel", "age": 16, "job": "science student", "role": "student",
+            "traits": ["analytical", "anxious", "earnest"],
+            "backstory": "He tracks campus patterns in spreadsheets and worries whenever the data gets weird.",
+            "relationships": {"Elena Brooks": "mentor", "Maya Chen": "friend", "Rosa Alvarez": "friend", "Talia Reed": "trusts", "Owen Moss": "curious-about"},
+            "voice_description": "(a thoughtful teenage boy, precise quick voice)", "model": _M,
+            "emoji": "🧑‍🔬", "home": "dorms", "catchphrase_hint": "wants evidence before deciding",
+            "schedule": [[7, 8, "dorms", "getting ready", {"energy": -2}], [8, 15, "science_lab", "classes and lab work", {"energy": -8, "social": 5}], [15, 17, "cafe", "study snack", {"hunger": -10, "social": 5}], [17, 22, "dorms", "homework", {"energy": -4}], [22, 7, "dorms", "sleeping", {"energy": 28}]],
+        },
+        {
+            "name": "Maya Chen", "age": 15, "job": "art student", "role": "student",
+            "traits": ["creative", "bold", "empathetic"],
+            "backstory": "She sketches everyone on campus and notices feelings before facts.",
+            "relationships": {"Elena Brooks": "mentor", "Samir Patel": "friend", "Rosa Alvarez": "family-friend", "Talia Reed": "trusts", "Owen Moss": "friend"},
+            "voice_description": "(an expressive teenage girl, bright confident voice)", "model": _M,
+            "emoji": "🎨", "home": "dorms", "catchphrase_hint": "describes events like scenes in a mural",
+            "schedule": [[7, 8, "quad", "morning sketching", {"energy": -1}], [8, 15, "school", "classes", {"energy": -8, "social": 6}], [15, 18, "quad", "art club on the grass", {"energy": -4, "social": 8}], [18, 22, "dorms", "finishing projects", {"energy": -4}], [22, 7, "dorms", "sleeping", {"energy": 28}]],
+        },
+        {
+            "name": "Rosa Alvarez", "age": 51, "job": "campus café owner", "role": "shopkeeper",
+            "traits": ["generous", "sharp", "protective"],
+            "backstory": "Her café is where students hear news, borrow courage, and sometimes get fed for free.",
+            "relationships": {"Elena Brooks": "friend", "Samir Patel": "friend", "Maya Chen": "family-friend", "Talia Reed": "friend", "Owen Moss": "rival"},
+            "voice_description": "(a lively middle-aged woman, rich amused voice)", "model": _M,
+            "emoji": "☕", "home": "cafe", "catchphrase_hint": "connects every problem to feeding people",
+            "schedule": [[6, 8, "cafe", "opening the café", {"energy": -3}], [8, 16, "cafe", "serving students", {"energy": -9, "social": 10}], [16, 18, "quad", "checking on regulars", {"social": 5}], [18, 22, "cafe", "closing and prep", {"energy": -4}], [22, 6, "cafe", "resting upstairs", {"energy": 24}]],
+        },
+        {
+            "name": "Talia Reed", "age": 34, "job": "school nurse", "role": "medic",
+            "traits": ["steady", "direct", "kind"],
+            "backstory": "She knows which kids are actually sick and which ones just need someone to listen.",
+            "relationships": {"Elena Brooks": "friend", "Samir Patel": "trusts", "Maya Chen": "trusts", "Rosa Alvarez": "friend", "Owen Moss": "ally"},
+            "voice_description": "(a steady adult woman, gentle firm voice)", "model": _M,
+            "emoji": "🩺", "home": "nurse_office", "catchphrase_hint": "triages feelings and injuries together",
+            "schedule": [[7, 8, "cafe", "tea before clinic hours", {"hunger": -6}], [8, 16, "nurse_office", "nurse office hours", {"energy": -10, "social": 6}], [16, 18, "riverside_walk", "walking off the day", {"energy": -2}], [18, 22, "family_hall", "checking messages", {"social": 2}], [22, 7, "nurse_office", "resting on call", {"energy": 24}]],
+        },
+        {
+            "name": "Owen Moss", "age": 58, "job": "groundskeeper", "role": "worker",
+            "traits": ["patient", "superstitious", "observant"],
+            "backstory": "He has maintained the campus paths for decades and knows every pipe, root, and rumor.",
+            "relationships": {"Elena Brooks": "ally", "Samir Patel": "curious-about", "Maya Chen": "friend", "Rosa Alvarez": "rival", "Talia Reed": "ally"},
+            "voice_description": "(an older man, low slow outdoorsy voice)", "model": _M,
+            "emoji": "🧑‍🌾", "home": "grounds_shed", "catchphrase_hint": "blames the river, the weather, or old pipes first",
+            "schedule": [[6, 8, "grounds_shed", "tool check", {"energy": -2}], [8, 12, "riverside_walk", "grounds rounds", {"energy": -8}], [12, 13, "cafe", "lunch at the counter", {"hunger": -10, "social": 4}], [13, 17, "quad", "repairs around the quad", {"energy": -7}], [17, 21, "grounds_shed", "locking up", {"energy": -3}], [21, 6, "grounds_shed", "sleeping", {"energy": 26}]],
+        },
+    ],
+    "scenarios": [
+        {"id": "exam_postponed", "title": "Final exams are postponed", "event": "The principal announces final exams are postponed because the riverside road flooded overnight.", "focus": "How do students and adults react differently when a stressful deadline suddenly moves?"},
+        {"id": "cafe_closure", "title": "The café may lose its lease", "event": "A notice appears saying the campus café lease may not be renewed next semester.", "focus": "Why do shared places matter more than their official purpose?"},
+        {"id": "nurse_overflow", "title": "The nurse office fills up", "event": "Half the school comes to the nurse after a mysterious rash starts spreading during lunch.", "focus": "How does a community balance urgency, fear and practical care?"},
+    ],
+    "events": [
+        "The riverside path floods just before morning classes",
+        "A rumor spreads that the old gym is haunted",
+        "Someone paints a huge mural on the cafeteria wall overnight",
+        "The school bell starts ringing five minutes early every hour",
+        "A lost dog runs across the quad during lunch",
+        "The science lab windows glow blue after sunset",
+        "The café runs out of food during a surprise assembly",
+        "A teacher finds an anonymous protest flyer in every locker",
+    ],
+}