Webex Room Persona

Hackathon scaffold for Webex playtime: a big-screen app that gives a Webex room device a quirky personality (frame + animated eyes) reacting to vision events. Structured so multiple teammates can work in parallel without collisions.

For humans

• Run: npm install then npm run dev
• The stage is intentionally blank; drop content inside the frame later.
• Use the on-screen controls to test moods, gaze, and events.
• Game modes: Air Hockey and Mirror Match (use the Apps menu or ?app=mirror-match).

For agents

• Read AGENTS.md first; it is the single source of truth.
• Emit shared events via src/services/events.ts and src/contracts/vision.ts.
• Prefer eyesScenes.* over raw commands (see docs/EYES_API.md).
• Update docs when you change contracts or internal APIs.

Structure

• src/features/eyes: eyes, scenes, debug, and reactor.
• src/features/frame: frame + stage layout.
• src/services: shared event bus, logs, and voice.
• docs/: contracts and architecture notes.