SFomo: Bay Area events

Find a performer, band, comedian or act in Bay Area by name (words in `query` must all match; case-insensitive) and get their upcoming events, top venues, genres or topics and the platforms that list them. Names come only from public event listings; there are no contact details. Use it for "when is <band> playing" or "who plays at <venue>". Use get_event with an id for one event's full listing.

Build a subscribable calendar of upcoming Bay Area events from the user's interests. Returns a link that opens the calendar on SFomo (open_on_sfomo; give the user this first), subscribe links (Google Calendar, Apple/Outlook webcal, plain .ics) and a preview. The calendar refreshes itself every few hours, so new matching events keep appearing. An event is included if it matches ANY interest and no

Search upcoming Bay Area events (dance, AI, music, arts, food, sports, comedy, fun, exercise, volunteer, dating). All words in `query` must match title/location/performers/organizer/tags. Dates are local (America/Los_Angeles), YYYY-MM-DD.

Look up one upcoming event by its stable `id` (as returned by search_events / list_upcoming), with its source link and first_seen / last_seen / last_fetched dates.

List the next N days of events, optionally for one category, topic or place. `by_day` counts every match per date; when there are more than `limit`, the rows shown are spread across the days (earliest first within each day), so narrow with category, topic or place, or page a single day with search_events from/to.