find_parenting_guides
ChatGPTUse this when a parent asks a question about kids and screens, media, technology, or digital life: "is Roblox safe for an 8-year-old?", "how much screen time for a 5-year-old?", "what age for a first phone?", "how do I set up YouTube parental controls?", "is Squid Game ok for a 12-year-old?". Searches 14,000+ Screenwise parenting guides and returns candidates with title, summary, and opening excerpt. Choose the one that answers the question, then call read_parenting_guide for its full text. Do not use this for general parenting topics unrelated to media and technology (sleep training, potty training, food).
get_media
ChatGPTUse this to get the full Screenwise review of one title by slug (from search_media, lookup_titles or recommend_media): WISE scores with the reason for each dimension, the parent verdict, why it is great, what to watch for, age-fit note, conversation starters, FAQ, external ratings (IMDb, Rotten Tomatoes, Common Sense age), streaming services, related Screenwise guides, and what other Screenwise parents say. It also shows the parent the expanded score card for this title, so do not call show_recommendation_cards for it, and do not repeat the four scores the card shows. Answer the parent from the review.
give_feedback
ChatGPTUse this to tell the Screenwise team about a problem with these tools or their data: a WISE score or summary that looks wrong for a title, a search that returned the wrong work, a malformed or misleading response, or a capability you needed and could not find. One call per distinct issue; a person reads every one.
lookup_titles
ChatGPTUse this when you already have specific titles in mind (from the conversation or your own knowledge) and need their Screenwise WISE scores and age ranges before recommending or comparing them, e.g. "is Bluey or Peppa Pig better for my 3-year-old?" or checking your own list of suggestions. Up to 10 titles in one call. Returns the best catalog match per title with matchConfidence (0-1); below 0.75 the match is uncertain. Titles not in the catalog come back as not found: do not invent a score for them. It also shows the parent cards for the titles it matched, so put every title in one call, and do not call show_recommendation_cards for the same titles unless you are narrowing them to a shorter list with a note for each.
read_parenting_guide
ChatGPTUse this after find_parenting_guides to read one Screenwise guide in full (markdown), plus the catalog items it covers with their WISE scores. Answer the parent from it in your own words, keep it short, and link the guide URL for the details. It also shows the parent cards for the guide and the titles it covers, so do not call show_recommendation_cards for them. Some titles appear in a guide as warnings; the cards show each one's real score, so say which are which.
recommend_media
ChatGPTUse this when a parent wants ideas for what a child should watch, read, play, or listen to: "shows for my 6-year-old", "chapter books for a 3rd grader who loves dinosaurs", "board games for a 5th-grade birthday", "family movie night with a 4 and 9 year old", "podcasts for a road trip". Returns a pool of up to 30 candidates from the Screenwise catalog, each with WISE scores (Wholesome, Imaginative, Safe, Enriching, 0-100), age range, lines from the Screenwise review (oneLiner, whyGreat, watchFor), and widelyKnown (0-100, how familiar the title is to families; evidence, not quality). Choose the ones that fit this family yourself, then call show_recommendation_cards with your picks and a short note for each. It also works for a parent's own picks ("a thriller for my vacation"): omit kid_ages. Do not use this to rate one specific title (use search_media or lookup_titles) or for parenting advice questions (use find_parenting_guides).
search_media
ChatGPTUse this to find one specific movie, show, game, book, app, podcast, board game, YouTube channel, or website by title, e.g. "is Moana 2 ok for a 5-year-old?" or "what's the WISE score for Minecraft?". Returns an ARRAY of candidates ordered by matchConfidence (0-1). Treat >= 0.75 as a strong match; below that, disambiguate using releaseYear, type, and author/developer, or ask the user. If you have an external id (ISBN, IMDb, TMDB, IGDB, ASIN), pass it: id matches are exact. Pass the release year when you know it. Then call get_media for the full record.
show_recommendation_cards
ChatGPTUse this to show your chosen Screenwise picks or guides to the parent as visual cards (poster, WISE score, age range, your note, link). Call it AFTER recommend_media, search_media, or find_parenting_guides, with slugs from those results only. Not needed after get_media or lookup_titles, which already show cards for their titles. One item shows an expanded card with all four WISE scores; 2-8 items show a carousel. Write each note for this family in one sentence (under 200 characters), e.g. "Gentle and funny, and the sibling episodes fit your two." Each media card already shows the Screenwise one-line take on the title, so make your note about THIS family (their kids, ages, interests), not a description of the title. The cards also show title, score and age, so do not repeat them in your reply.
suggest_media
ChatGPTUse this when search_media or lookup_titles found no good match (zero results, or nothing above ~0.5 confidence) for a real movie, show, game, book, app, podcast, or board game the user asked about. Sends the title to the Screenwise editorial team, who review suggestions and score worthy titles. Do NOT call this for titles that matched, and never invent titles.
