Resolve Event From Post
resolve_intentFind the XP event a post means, from the words it uses. XP decides the match, not the reader.
Returns ranked candidates [{event_id, name, venue, city, date_utc, score (0-1), why, facts:
{country, hours_until (null when the date or time is TBD), date_tbd, started, same_day}}], ambiguous
(why no single event wins, e.g. "3 nights at Sphere", else null), match (matched, ambiguous or
not_in_catalog: only whether XP found the event) and, when matched, verdict for the top
candidate: {qualified, reason (null, non_us, unknown_country or past_event), rule_set}. Same-day
and date-TBD events qualify; a postponed event or a date more than two years out counts as TBD.
Parking listings and cancelled events never match, and a tribute, themed or inspired show or a
season-ticket package matches only when the post says so. An upcoming, certain show beats a past
or if-necessary one unless the post names that date. same_day means within 24 hours, or today at
the venue when only the time is TBD. Duplicate listings resolve to one event.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| city | No | City as written, e.g. 'Chicago' or 'Chicago, IL'. | |
| limit | No | How many candidates to return (max 20). | |
| venue | No | Venue as written, e.g. 'Soldier Field'. | |
| date_text | No | The date as the post words it when there is no exact date, e.g. 'this weekend'. | |
| performer | Yes | Artist or teams as the post writes them, e.g. 'Bears vs Packers'. | |
| event_date | No | Event date when the post gives one (YYYY-MM-DD). |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||