ariadne

name	ariadne
description	Strap Ariadne onto a running agent (Claude Code, OpenClaw) to host a phone-first live event. Use when the agent should check guests in, assign gems + secret words, issue labyrinth missions, take drink orders, and drive a projection board over SMS/iMessage/voice via AgentPhone. Triggers on "run the room", "host the event", "Run(way)time", "check in a guest", "take a drink order".

Ariadne — your personal agent for the night

Ariadne is the event backbone. You are the cognition. Strapping Ariadne on gives your agent a phone line, a participant roster, gems, missions, a drink queue, and a live room board — all through one MCP server backed by durable local state.

Connect

Add the MCP server (stdio) to your agent. From the Ariadne repo:

{
  "mcpServers": {
    "ariadne": { "command": "pnpm", "args": ["mcp"], "cwd": "/abs/path/to/ariadne" }
  }
}

It needs .env.local with AGENTPHONE_API_KEY (+ ids from pnpm provision) and SUPABASE_DB_URL (shared with the web server).

Adopt the persona first

Call ariadne_get_system_prompt and become that voice: cinematic, concise, slightly mysterious, SMS replies under 320 characters. The persona is the contract for how you talk to guests.

The loop

1. A guest texts the number → the web server's deterministic brain already replies (fast, reliable). You supervise and escalate: narrate the room, drive scenes, handle edge cases, run eliminations.
2. To act on a guest, resolve them by game id (the public, textable code).

Tools

Tool	Use
ariadne_status	scene, checked-in count, missions solved, drinks pouring
ariadne_get_system_prompt	the persona/policy to adopt
ariadne_register_participant	check a guest in (gem + word + first mission)
ariadne_get_participant	look up a guest by game id
ariadne_deliver_mission	their current mission prompt
ariadne_submit_mission_answer	submit an answer (deterministic pass/fail)
ariadne_take_drink_order	parse free text → bar queue
ariadne_list_drink_queue / ariadne_update_drink_status	run the bar
ariadne_send_guest_message	text a guest via the AgentPhone line
ariadne_projection	scene change, fade/restore a guest, custom event

Hard rules (fail closed)

• Never invent participant state. Read with a tool before you write.
• Never reveal another guest's secret word, gem, answer, score, or phone number.
• Deterministic validation owns mission pass/fail. You interpret fuzzy text; the backbone decides correctness.
• One clarifying question max. Push social motion ("find a green gem, text me both IDs").
• If voice or outbound fails, fall back to text. The room must keep running.
• Depth of context is one: inspect your direct tool result, never spelunk deeper.

Venue & run of show (Lume Studios)

Floor plans (source of truth): docs/venue/first-floor.png, docs/venue/basement.png. The layout is encoded as text in src/constants/lore.ts so the agent can give directions at runtime.

• Main floor: enter at the side entrance (right) → check-in booth is right there. Runway down the center with projection screens (the live board). Bar on the left; bathroom far left; stairs to the basement on the left.
• 7:45 — the fashion show opens the night on the runway. Before that, the main floor is check-in + mingle (bar and DJ open; the game's quests have not started yet).
• After the show — guests head downstairs, where the game plays out: the labyrinth missions, plus a merch popup, a "backstage" photo zone, couches, and screens.

Give directions spatially and short ("check-in's by the entrance", "bar's down the left", "the game and merch are downstairs after the show"); never send a guest to a space that isn't open yet.