List owned Steam games (thin: appid, name, playtime, last-played, installed).

Args: installed_only: Only games installed on THIS machine (requires local Steam). search: Case-insensitive substring match on the game name. sort: One of "playtime" (desc), "name" (asc), "last_played" (desc). limit: Page size (1-500). offset: Pagination offset.

Full details for specific Steam games: playtime breakdown + local install info.

Args: appids: Steam appids to fetch (max 50 per call). include_dlcs: Reserved; Steam DLC ownership is not separately derivable here.

Resolve a Steam vanity slug or profile URL to a SteamID64.

Report Epic auth state (does a valid/refreshable token exist, and from where).

Get the Epic login URL. Sign in there, then copy the authorizationCode for epic_login.

Exchange an Epic authorizationCode (from epic_get_login_url) for a stored session.

List owned Epic games (thin: app_name, catalog_item_id, namespace, title, installed).

The first call warms a persistent catalog-metadata cache (titles + game/DLC categories), so it may be slow on a large library; subsequent calls are fast. Only a page is returned.

Args: installed_only: Only games installed here (via local Legendary/Heroic state). search: Case-insensitive substring match on the title. include_dlcs: Include DLC/add-on entries (excluded by default). limit: Page size (1-500). Use pagination for large libraries. offset: Pagination offset.

Full text details for specific Epic games (title, description, developer, install info).

Args: app_names: Epic app_name identifiers (from epic_list_games), max 50 per call. include_dlcs: Include entries that are DLC (excluded by default).

Search IGDB by name (thin: id, name, release_year). Use igdb_get_game_details for more.

Args: query: Free-text game name to search for. include_dlcs: Include DLC/expansion results (excluded by default). limit: Page size (1-500, IGDB default 10). offset: Pagination offset.

Full text metadata for specific IGDB game ids (summary, ratings, genres, companies...).

Results are cached on disk per id. Set force_refresh=True to bypass the cache and pull fresh data for these ids (e.g. when the prompt asks for the latest ratings).

Args: ids: IGDB game ids (from igdb_search_games / igdb_lookup_by_steam_appid), max 50 per call. include_dlcs: Include ids that are DLC/expansions (excluded by default). force_refresh: Re-fetch from IGDB and overwrite the cached records for these ids.

Map Steam appids to IGDB games (id + name) — bridges a Steam library to IGDB metadata.

Args: appids: Steam appids (max 50 per call). force_refresh: Re-query IGDB and overwrite the cached matches for these appids.

Flush cached library/metadata data so the next call re-fetches from the network.

Use when data may be stale (e.g. "get the latest ratings/library" or after you've installed/bought games). Auth tokens are NOT cleared — this refreshes data, not login. For refreshing just a few specific games, prefer force_refresh on the igdb_* tools.

Args: target: Which caches to clear — "all" (default), "steam", "epic", or "igdb".