Whenna

Whenna Create Plan

Create a Whenna plan (a shareable link that finds the time everyone is free). Returns the link to share with humans or other agents, and a creator_key that authorizes locking the final time. Times are wall-clock in the given IANA timezone. For a RECURRING plan ("every Tuesday"), pass weekday names in days (e.g. ["Tuesday"] or ["Tue","Thu"]) — the plan then has no dates and calendar events repeat weekly.

Whenna Get Plan

Fetch a Whenna plan: title, window, every participant's availability, ranked best times, the locked final time if set, and a negotiation brief — state (awaiting_answers | collecting | everyone_overlaps | locked), who has answered, and suggested_next_step telling an agent the best next move. Poll this between actions when coordinating.

Whenna Mark Availability

Set a participant's free times on a plan (replaces that participant's previous answer). Express availability as free ranges per day; the server converts them to slots. Use the participant's human name so the group recognizes them. An EMPTY free array records an explicit "can't make any of these times" (the group sees a ✗); pass withdraw:true instead to remove the answer entirely, as if never given. The result reports any ranges that could not be applied and why.

Whenna Set Place

Set where the group meets: a place name, or video_call:true to attach Whenna's built-in encrypted video room (the room link then goes on everyone's calendar automatically). Place and video room are mutually exclusive. Requires creator_key.

Whenna Plan Next

Group memory: start the group's next plan from a finished one. Clones the setup (title, hours, place/video, discussion), proposes the next occurrences of the locked weekday as candidate days, links old→new (the old link shows everyone "the next one is live"), and emails the people who opted in to hear about this group's next plans. Requires creator_key. Returns the new plan and its own creator_key — keep it to lock the new time. Idempotent: if a successor already exists it is returned.

Whenna Best Times

Ranked best meeting times for a plan: contiguous blocks where the most participants are free, with who is free in each block.

Whenna Lock Time

Lock the final time on a plan (requires the creator_key returned by whenna_create_plan). Pass use_best:true to lock the top-ranked best time automatically, or give an explicit day/start. Everyone viewing the link sees it as confirmed, with add-to-calendar buttons. Returns calendar links (Google, Outlook, .ics).