What2Watch

interface GetRecommendationParams {  // Location & Language  location?: string;              // Country code (default: "US")  languages?: string[];           // Preferred languages ["en", "es"]
  // User Profile  gender?: string;                // User's gender  age_group?: string;             // "kids" | "teenager" | "young adult" | "adult" | "senior"
  // Platforms  platforms?: string[];           // ["netflix", "prime", "disney_plus", "hulu", "hbo_max", "apple_tv_plus"]  channels?: string[];            // Cable/linear TV channels
  // Taste Profile  liked_media?: string[];         // Titles they enjoyed ["Breaking Bad", "The Wire"]  disliked_media?: string[];      // Titles to avoid  watched_media?: string[];       // Already seen (excluded from results)
  // Filters  media_type?: string;            // "movie" | "series" | "documentary"  genre?: string;                 // "comedy" | "drama" | "action" | "thriller" | "sci-fi" | "horror" | "romance"  mood?: string;                  // "relaxing" | "exciting" | "thought-provoking"  watch_time?: string;            // "now" | "tonight" | "later"
  // Discovery  surprise_me?: boolean;          // Discover underrated hidden gems (default: false)  limit?: number;                 // Max results 1-10 (default: 5)}

interface SearchContentParams {  keywords?: string;              // Text search (title, actor name, plot keywords)  genres?: string[];              // Filter by multiple genres  min_rating?: number;            // Minimum IMDB score 0-10 (e.g., 7.5)  year_from?: number;             // Release year start (e.g., 2020)  year_to?: number;               // Release year end (e.g., 2024)  location?: string;              // Country code (default: "US")  languages?: string[];           // Preferred languages  platforms?: string[];           // Streaming services filter  liked_media?: string[];         // Boosts similar content in ranking  disliked_media?: string[];      // Titles to avoid  watched_media?: string[];       // Already seen (excluded)  media_type?: string;            // "movie" | "series" | "episode" | "documentary"  genre?: string;                 // Single genre filter  mood?: string;                  // "relaxing" | "exciting" | "thought-provoking"  limit?: number;                 // Max results 1-10 (default: 5)}

interface GetContentDetailsParams {  content_id: string;             // The ID from search/recommendation results}

interface GetScheduleParams {  time_range?: string;            // "now" (next 2h) | "tonight" (6PM-midnight) | "today" | "tomorrow"  channels?: string[];            // Filter by channel ["hbo", "nbc", "espn", "abc", "cbs", "fox"]  location?: string;              // Country code (default: "US")  liked_media?: string[];         // Boosts similar content  disliked_media?: string[];      // Titles to avoid (excluded)  watched_media?: string[];       // Already seen (excluded)  media_type?: string;            // "movie" | "series" | "sports" | "news" | "documentary"  genre?: string;                 // "drama" | "comedy" | "sports" | "news"  genres?: string[];              // Multiple genres ["sports", "action"]  min_rating?: number;            // Minimum IMDB score 0-10  limit?: number;                 // Max results 1-10 (default: 5)}

interface GetTrendingParams {  location?: string;              // Country code (default: "US")  platforms?: string[];           // Filter by streaming service  liked_media?: string[];         // For reference/personalization  disliked_media?: string[];      // Titles to avoid (excluded)  watched_media?: string[];       // Already seen (excluded)  media_type?: string;            // "movie" | "series"  genre?: string;                 // Filter by genre  time_window?: string;           // "day" | "week" | "month" (default: all time)  limit?: number;                 // Max results 1-10 (default: 5)}

interface GetAvailableSourcesParams {  location?: string;              // Country code (default: "US")  include_channels?: boolean;     // Include TV channels with schedules (default: true)  include_platforms?: boolean;    // Include streaming platforms (default: true)}

interface ToolResponse {  results: ContentItem[];         // Array of movies/shows  total_count: number;            // Total matches found  filters_applied: object;        // Which filters were used  next_steps: string[];           // Contextual follow-up suggestions}
interface ContentItem {  id: string;                     // Unique identifier  title: string;                  // Display title  type: "movie" | "series";       // Content type  year: number;                   // Release year  rating: number;                 // IMDB rating 0-10  genres: string[];               // Genre tags  plot: string;                   // Brief description  runtime?: number;               // Minutes (for movies)  seasons?: number;               // Season count (for series)  availability: Availability[];   // Where to watch}
interface Availability {  platform: string;               // "netflix", "hulu", etc.  platform_name: string;          // "Netflix", "Hulu", etc.  type: "subscription" | "free" | "rent" | "purchase";  link?: string;                  // Direct watch link  price?: number;                 // For rent/purchase}