clear_player_profile
ChatGPTDelete all saved player defaults when profile storage is available.
find_coaching_videos
ChatGPTUse when the user explicitly requests more coaching videos, a specific video topic, or videos from a particular coach. Search the public library and add up to three new results to this conversation’s video panel. Do not call for every event search. An empty result means no suitable clip was found.
get_event
ChatGPTGet public event and division facts, including each division’s grounded USTA points outlook, draw size, format, surface, age, fee, selection and scoring. Points are published values at stake, not a forecast of a player’s ranking or rating change. Use public_id from list_events. Returns event: null when not found or not public.
get_player_profile
ChatGPTReturn saved player age, gender, UTR, and location when profile storage is available. Missing values are null.
list_events
ChatGPTSearch the TNNS HEAD public USTA, UTR, and ITF catalog. Discovery defaults to ranked top-20 results; use response_mode=ranked and limit=20, with states and date_windows together. Ranked mode evaluates all scope matches (up to 1000, otherwise asks for a narrower scope) and returns the top 20 by reported player fit, explicit preferred_usta_levels, and registration state. Use rank_offset only when the user asks for more. Ranked results retain selection and profile-comparison facts; get_event provides finalist division details, exact points tables, and source links. Returns search_scope, player context, and event IDs for get_event. Ranked mode reports complete evaluation and next_rank_offset for explicit requests for more; explicit detailed mode is for chronological browsing and requires following next_cursor before claiming complete coverage. Pass the returned search_reference to render_shortlist instead of copying scope and player context; the server restores them for the widget. Saved player defaults are used when available; player input overrides them for this search only. Set player_scope=other_player for someone else. Set player_source=chatgpt_suggested when values come from ChatGPT memory or inference, user_provided for values stated in the current request, or editor for values the user submitted in the inline control; use player_field_sources if fields differ. Age, gender, and UTR are context, not eligibility filters. ZIP resolves to city/state.
load_shortlist_videos
ChatGPTWidget-only deferred coaching suggestions after tournament cards render.
open_player_panel
ChatGPTShow a compact inline player summary and expandable editor only when the user asks to review or edit player settings. Pass only age, male/female category, UTR, and city/state or ZIP supported by the current conversation in suggested_player; omit uncertain fields and never pass a name. Set player_scope to other_player for someone other than the usual player. Suggestions are not saved automatically.
render_shortlist
ChatGPTRender the final ranked TNNS HEAD shortlist once, after list_events and get_event. Pass search_reference from list_events (omit copied context), a concise recommendation naming the first choice, main tradeoff and grounded points context where relevant, 1–6 returned event public_ids, the relevant division_public_id when known, and a short evidence-based reason for each. The widget shows division entries on each card; expanded event details show USTA points tables or non-ranking/unverified status. The server re-reads public catalog facts, rejects out-of-scope or missing events and mismatched divisions, and uses these same picks for location output. Do not call for an intermediate search page.
show_coaching_videos
ChatGPTRender the first three conversation coaching videos inline when an event search has no tournament shortlist to show. Call once after a completed no-results search; the shortlist widget handles its own videos after tournament cards render. Pass a topic only if the user stated one.
update_player_profile
ChatGPTSave or clear supplied player defaults only when profile storage is available. Omitted fields are unchanged; null clears a field. Temporary search overrides belong in list_events instead.
video_suggestions_panel
ChatGPTConversation side-panel entrypoint for coaching videos. Read the current conversation suggestions without performing a new search.