娱乐内容推荐引擎

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
}