proxy2021/media_library

Cross-media library for browsing, searching, rating, tracking, and discovering books, movies, TV series, games, music, and photos from your Knowledge Cortex entity index

Tool Reference

enso_media_library_browse (primary)

Browse all media entities with filters. Supports filtering by media type (books, movies, games, music, photos, tv, documentaries), consumption status, favorites, minimum rating, collection membership, and sorting/grouping options. Use when the user says: 'show my media library', 'browse my books', 'show all movies', 'list my games', 'what have I completed'.

Parameters:

• mediaType (string): Filter by media type: all, books, movies, tv, documentaries, games, music, photos (default: all)
• status (string): Filter by consumption status: not_started, in_progress, completed, dropped, on_hold
• favorite (boolean): Filter to favorites only
• minRating (number): Minimum user rating (1-10)
• collectionId (string): Filter to items in a specific collection
• sortBy (string): Sort by: title, rating, updatedAt, dateCompleted (default: title)
• groupBy (string): Group results by: mediaType, status, rating (default: none)
• limit (number): Max results per page (default: 50)
• offset (number): Pagination offset (default: 0)

enso_media_library_search

Full-text search across all indexed media entities. Searches titles, tags, semantic tags, and metadata. Returns ranked results with match reasons. Use when the user says: 'search for sci-fi books', 'find martial arts movies', 'search strategy games'.

Parameters:

• query (string): Search query string
• mediaType (string): Limit search to a media type: books, movies, tv, documentaries, games, music, photos
• limit (number): Max results (default: 30)

enso_media_library_rate

Rate a media entity on the 10-point half-star scale (1–10 integer, where 2 points = 1 star). Accepts both integer points (1–10) and star notation (e.g. 4.5 stars = 9/10). Returns a starsDisplay like "★★★★½". Use rating=0 to clear. Use when the user says: 'rate this book', 'give it an 8', '4.5 stars', '9 out of 10'.

Parameters:

• entityId (string): The entity ID to rate
• rating (number): Rating 1–10 (0 to clear); or star notation 0.5–5.0
• notes (string): Optional notes about the rating

enso_media_library_status

Update consumption status and progress for a media entity. Use when the user says: 'I started reading this', 'mark as completed', 'I dropped this show', 'update my progress'.

Parameters:

• entityId (string): The entity ID to update
• status (string): Status: not_started, in_progress, completed, dropped, on_hold
• progress (string): Progress description (e.g., 'Chapter 5', '45%', 'Episode 3')

enso_media_library_favorite

Toggle or set the favorite flag on a media entity. Use when the user says: 'favorite this', 'add to favorites', 'unfavorite this book'.

Parameters:

• entityId (string): The entity ID to toggle favorite
• favorite (boolean): Set true/false, or omit to toggle

enso_media_library_collection

Manage media collections: create, list, view (with resolved entities), add/remove items, or delete collections. Use when the user says: 'create a collection', 'add to reading list', 'show my collections', 'view watch later list'.

Parameters:

• action (string): Action: create, list, view, add_item, remove_item, delete
• collectionId (string): Collection ID (for view, add_item, remove_item, delete)
• name (string): Collection name (for create)
• description (string): Collection description (for create)
• entityId (string): Entity ID to add/remove

enso_media_library_stats

Cross-media statistics and insights from your entire library. Shows totals by type, rating distributions, completion rates, top-rated items, recent activity, and more. Use when the user says: 'show my library stats', 'how many books have I read', 'media statistics', 'library overview'.

Parameters:

• mediaType (string): Limit stats to a specific media type (optional)

enso_media_library_add

Manually add a new media entity to the library. Use when the user says: 'add a book', 'add movie to library', 'register new game'.

Parameters:

• type (string): Entity type: book, movie, tv-series, documentary, game, album, artist
• title (string): Title of the entity
• imageUrl (string): Cover image URL (optional)
• tags (string): Comma-separated tags
• semanticTags (string): Comma-separated semantic tags

enso_media_library_discover

AI-powered cross-media discovery suggestions based on your ratings, favorites, and consumption patterns. Analyzes taste clusters from semantic tags to recommend items you might enjoy. Use when the user says: 'suggest something to watch', 'recommend books', 'what should I play next', 'discover new media'.

Parameters:

• mediaType (string): Limit suggestions to a media type (optional)
• limit (number): Max suggestions per category (default: 5)

enso_media_library_nl_search

Natural language hybrid search using SQLite FTS5 (keyword/BM25) + semantic tag similarity with RRF fusion. Understands concepts, genres, and themes — not just exact keywords. Auto-rebuilds the search index on first use. Use when the user says: 'find dystopian books', 'show me space movies', 'search for strategy games', 'find something like Dune', 'semantic search my library'.

Parameters:

• query (string): Natural language search query (e.g. 'dystopian sci-fi', 'mind-bending thrillers')
• action (string): Action: search (default), rebuild (sync FTS5 index), status (index stats)
• mediaType (string): Filter by media type: books, movies, tv, documentaries, games, music
• limit (number): Max results (default: 20, max: 100)
• expand (boolean): Enable semantic query expansion (default: true)

enso_media_library_bulk_enrich

Bulk metadata enrichment orchestrator. Propagates cache enrichment to entity index and calls external APIs: TMDB (movies/TV/documentaries), Google Books (books), Steam Store (Steam games), IGDB via Twitch OAuth (console/non-Steam games). Use when the user says: 'enrich my library', 'bulk enrich', 'fill missing metadata', 'enrich movies with TMDB', 'enrich games with IGDB'.

Parameters:

• action (string): Action: status (show coverage), preview (dry run), enrich (execute)
• mediaType (string): Filter: all, books, movies, tv, games (default: all)
• limit (number): Max entities to API-enrich per run (default: 50)

enso_media_library_batch_seed

Batch auto-seed engagement data (ratings, favorites, consumption status) from existing metadata in wiki pages. Converts Amazon stars, TMDB scores, and Metacritic ratings to the 1-10 user rating scale. Use when the user says: 'seed my ratings', 'auto-populate ratings', 'bootstrap engagement data'.

Parameters:

• action (string): Action: preview (dry run), seed (apply), status (show coverage)
• skipExisting (boolean): Skip entities that already have a user rating (default: true)

enso_media_library_dashboard

Library health dashboard showing engagement coverage, discovery readiness, and an Engagement Health Score (0-100). Shows per-type breakdowns, gap alerts, and quick actions. Use when the user says: 'show library health', 'dashboard', 'library overview', 'engagement stats'.

enso_media_library_stats

Cross-media statistics and insights. Shows totals by type, rating distributions, completion rates, top-rated items. Use when the user says: 'show my library stats', 'how many books have I read', 'media statistics'.

Parameters:

• mediaType (string): Limit stats to a specific media type (optional)

enso_media_library_timeline

View media consumption timeline — started, completed, rated, favorited events over time grouped by month. Use when the user says: 'show my timeline', 'media consumption history', 'what did I read this month'.

Parameters:

• period (string): Time period: week, month, quarter, year, all (default: all)
• mediaType (string): Filter by media type

enso_media_library_taste_profile

Analyze consumption patterns and generate a persistent taste profile: genre affinities, media preferences, cross-media connections, and a natural-language taste DNA summary. Use when the user says: 'show my taste profile', 'analyze my taste', 'what do I like'.

Parameters:

• refresh (boolean): Force regeneration (default: false)

enso_media_library_smart_collections

Auto-generate thematic smart collections from semantic tag clusters. Actions: generate (propose collections), apply (save a proposal), refresh (update existing), list. Use when the user says: 'generate smart collections', 'auto-organize my library', 'find themes in my media'.

Parameters:

• action (string): Action: generate, apply, refresh, list
• proposalId (string): Proposal ID to apply

enso_media_library_franchise

Detect and manage franchise/series groupings across books, movies, TV, and games. Actions: detect, list, view, merge. Use when the user says: 'find franchises', 'group related media', 'show series', 'what franchise is this part of'.

Parameters:

• action (string): Action: detect, list, view, merge
• franchiseId (string): Franchise ID (for view/merge)
• entityId (string): Entity ID to look up or merge

Rating Scale

The media library uses a 10-point half-star scale (1–10 integer) that displays as familiar 0.5–5.0 stars:

| Points | Stars | Label | |--------|-------|-------| | 10 | ★★★★★ | Masterpiece | | 9 | ★★★★½ | Excellent | | 8 | ★★★★ | Very Good | | 7 | ★★★½ | Good | | 6 | ★★★ | Above Average | | 5 | ★★½ | Average | | 4 | ★★ | Below Average | | 3 | ★½ | Poor | | 2 | ★ | Very Poor | | 1 | ½ | Terrible |

Both integer (8) and star notation (4.0 stars = 8) are accepted. Use rating=0 to clear.