Agreed

Agreed: adds the user's own picks to a group decision someone else started. Use when the user shares an Agreed link and says things like "add mine", "put Dishoom on the list", "can we add a few more" or "here's what I'd suggest". Options added before anyone swipes are in everyone's first round; later ones reach each person's next round. Same option fields as decide_together, and no people's names.

add_options

Agreed: helps a group agree WHEN — a date, a weekend, a trip's dates, or a regular slot. Call this when the user and other people need to find a time rather than choose a thing: "when can we all…", "find a date for…", "which weekend works…", "what night suits everyone…", "when are we free for…", "a regular night for five-a-side", "a monthly book club". One-off: pass `options`, each a day (start) or a stretch of days (start and end, like a Fri–Sun weekend away), 2–12 of them, today or later, with times only if the user named them. Recurring: pass `cycle` and `nights`, each a weekday (plus week 1 or 2 of a fortnight, or which one of the month) with times if known. Everyone ticks the options they can make (or "if need be") on their own phone; the host picks the one that works. Never put people's names in the title. Returns an invite link for the group, a host link only for the user, and a room ref for room_status.

agree_when

Agreed card only: changes a regular-night room's nights and times from the host's own card, before anyone else has answered. Needs the host link.

edit_when

Agreed: how a group decision is going — how many have finished swiping (or, for agree_when, answered) and what the group agreed on once it's settled. Use when the user asks "what did they pick?", "has everyone done it?", "has everyone answered?", "is it decided?", "where are we going then?" or follows up on an Agreed link.

room_status

Agreed: puts a choice to a group so they can decide together. Use when the user is choosing something with other people (friends, a partner, family, housemates, a team) and wants them to weigh in, e.g. "help us decide where to eat", "we can't decide what to watch", "put it to the group", "get agreed on…". Not for choices the user is making alone. Pass the options you suggested, each with an emoji and a one-line description (they become what people swipe), plus the photo hints you know (category, place, year, artist, wikipediaTitle). Fold the group's constraints (dietary needs, budget, dates) into which options you choose; never put people's names in the title or options. Everyone swipes yes or no on their own phone and Agreed shows what the group agrees on. Returns an invite link for the group, a host link only for the user, and a room ref for room_status.

decide_together

Agreed: reveals the result to everyone in the room and ends swiping, as the host's Hold to reveal on the Agreed card does. Only call it when the user, who set this room up, explicitly asks to reveal it now ("reveal it", "everyone's in, show us"). Never decide on your own that the group is complete — only the user knows who's still coming. Pass the user's own host link from when the room was set up; a group invite link can't reveal.

reveal_result