'
def render_hud(session) -> str:
s = session.state if session else None
cur = s.rank if s else None
items = []
for i, r in enumerate(RANK_LADDER):
cls = ""
if cur and r == cur:
cls = "cur"
elif s and i < s.stage_idx:
cls = "done"
items.append(f'
{html.escape(r)}
')
ladder = f'
{"".join(items)}
'
if s and s.status == "playing":
stage = session.orchestrator.bank.stage(s.stage_idx)
nq = len(stage["questions"])
stage_v = f"{s.stage_idx + 1}/{len(session.orchestrator.bank)} — {stage['concept']}"
trial_v = f"{s.q_idx + 1}/{nq}"
strikes_v = '' + "◆" * s.attempt + "◇" * (MAX_ATTEMPT - s.attempt) + ""
elif s and s.status == "won":
stage_v, trial_v, strikes_v = "All cleared", "—", "🏆"
elif s and s.status == "lost":
stage_v, trial_v, strikes_v = "Quest ended", "—", "◆◆◆"
else:
stage_v, trial_v, strikes_v = "Awaiting the summons", "—", "◇◇◇"
return (
f'
'
f'
{html.escape(cur or "—")}
'
f'{ladder}'
f'
Stage
{html.escape(stage_v)}
'
f'
Trial
{html.escape(trial_v)}
'
f'
Strikes
{strikes_v}
'
f'
'
)
WELCOME_TALE = ('
The Realm of the Hub awaits
'
'
Herald-Mentor'
'A spirit stirs in the Realm of the Hub. Press Begin thy quest to be '
'summoned, Squire, and face thy first trial.
')
RULES_HTML = (
'
The Decree of the Trials
'
'
Free the arcane arts — rise from Squire to Grandmaster.
'
'
Six stages, each holding several trials.
'
'
Answer the Herald\'s riddle true to advance and rise in rank.
'
'
Three failed attempts end thy quest.
'
'
Clear all six stages to be crowned Grandmaster.
'
'
')
def begin():
"""Summon the knight, pose the first trial, and swap Begin for the answer input."""
n = narrator()
session = GameSession(validator=Validator(judge=Judge(n.llm)))
messages = [{"role": "system", "content": n.system_block(session)},
{"role": "user", "content": KICKOFF}]
display = [("herald", n.run(session, messages))]
return (render_tale(display), session, messages, display, render_hud(session),
gr.update(visible=False), gr.update(visible=True), gr.update(visible=True))
def answer(text, session, messages, display):
"""One player turn: judge the answer, react, pose the next trial if cleared."""
if session is None or session.state.status != "playing" or not text.strip():
tale = render_tale(display) if session else WELCOME_TALE
return tale, session, messages, display, "", render_hud(session)
n = narrator()
before = (session.state.stage_idx, session.state.q_idx)
display = display + [("knight", text)]
messages.append({"role": "user", "content": text})
display = display + [("herald", n.run(session, messages))]
moved = (session.state.stage_idx, session.state.q_idx) != before
if session.state.status == "playing" and moved: # cleared -> pose next trial
messages = [{"role": "system", "content": n.system_block(session)},
{"role": "user", "content": KICKOFF}]
display = display + [("herald", n.run(session, messages))]
return render_tale(display), session, messages, display, "", render_hud(session)
with gr.Blocks(title="The Adventures of the HF Knight", css=PARCHMENT_CSS, head=HEAD_JS) as demo:
gr.Markdown("# 🛡️ The Adventures of the HF Knight", elem_id="title")
st_session = gr.State()
st_messages = gr.State()
st_display = gr.State()
with gr.Row():
with gr.Column(scale=3):
tale = gr.HTML(WELCOME_TALE)
with gr.Row():
begin_btn = gr.Button("⚔️ Begin thy quest", scale=1, elem_id="beginbtn")
box = gr.Textbox(placeholder="Speak thy answer, Squire...", show_label=False,
scale=5, elem_id="answerbox", visible=False, max_length=200)
send = gr.Button("⚔️ Answer", scale=1, elem_id="sendbtn", visible=False)
with gr.Column(scale=1, elem_id="rightcol"):
hud = gr.HTML(render_hud(None))
gr.HTML(RULES_HTML)
begin_btn.click(begin, outputs=[tale, st_session, st_messages, st_display, hud,
begin_btn, box, send])
_in = [box, st_session, st_messages, st_display]
_out = [tale, st_session, st_messages, st_display, box, hud]
box.submit(answer, _in, _out)
send.click(answer, _in, _out)
if __name__ == "__main__":
demo.launch()