Cupid, an interactive rom-com

Present THREE potential matches as a carousel of cards. User must SELECT one match before proceeding. Pass the `mortal_id` echoed by cupid-present-mortal so this loads the chosen mortal's matches. The widget will send a message like 'I choose [Name] as my match! (match_id=N, mortal_id=…)' when user selects — pass that name as match_name and that number as match_id to cupid-show-compatibility. Cupid serves its own fictional characters: their profiles and their portraits come from this app, and the card on screen already shows each portrait. They are not real people, so there is nothing to look up — never search the web, generate an image or show a photo for any of them; a found photo would be a real stranger's face.

cupid-present-matches

Show compatibility analysis for the selected match. Pass match_name (the name in the player's 'I choose [Name] as my match!' message) AND match_id (the message carries it as `match_id=N`; otherwise the carousel position — 1=first, 2=second, 3=third). The server resolves the name; it wins over a disagreeing number. Cupid serves its own fictional characters: their profiles and their portraits come from this app, and the card on screen already shows each portrait. They are not real people, so there is nothing to look up — never search the web, generate an image or show a photo for any of them; a found photo would be a real stranger's face.

cupid-show-compatibility

Show final evaluation and Cupid's revealed astrological tendencies.

cupid-complete-game

Present the fictional mortal character for the Cupid matchmaking game. Shows their zodiac-based personality. The player picks a mortal in the Home chooser ('I choose {Name} as my mortal') — pass `mortal="{Name}"` (the exact name). Never call it in the same turn as cupid-start-game: the chooser is on screen and the player hasn't picked yet. The tool echoes a `mortal_id` — thread it through the rest of the arc. After presenting, WAIT for user to say they're ready to meet the match. Cupid serves its own fictional characters: their profiles and their portraits come from this app, and the card on screen already shows each portrait. They are not real people, so there is nothing to look up — never search the web, generate an image or show a photo for any of them; a found photo would be a real stranger's face.

cupid-present-mortal

Load scene structure rules and playbook for running the 4 scenes

cupid-get-scene-guide

Start a game of Cupid, an interactive rom-com: shows the home card with the cast of fictional characters to choose from and loads the game's voice and rules. Use when the user asks to play Cupid or start a new game.

cupid-start-game

Draw the Fates card at the crossroads — the couple's potential and the story's rail — after the player takes the Fates door. The ending is not told here: when the player's message is "Leave it to the Fates." call cupid-fates-reveal.

cupid-fates

The ending the couple's score has earned. Call it only after the Fates card is on screen and the player's message is "Leave it to the Fates." — never straight from the scorecard — with the same mortal_id, match_id and final_score the Fates card was drawn with. Returns the band, whether they end up together, the whole forecast and the epilogue playbook — then write the epilogue as your reply. No tool follows.

cupid-fates-reveal

Open date N (2, 3, 4, …) for the current couple after the player takes the Dates door. Renders the date chapter card and returns the continuing-date playbook.

cupid-dates

Plays a scene. Draws the scene card — the chapter's title and narration, the dialogue as a script with the couple's faces, and Cupid's 3-4 choices on its last page — which the player pages through and presses. Put the whole scene in scene_title, narration and dialogue — the same scene you would have written — and pass mortal_id and match_id so the card knows the couple. On this host the card is always drawn above your words, so a scene written as text arrives after its own choices: never write the scene or the options as text; a short line of your own around the card is fine. After the fourth scene (or an early exit), call cupid-complete-game instead.

cupid-present-options