steam-games-mcp 0.2.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -0,0 +1 @@
1
+ {"version":3,"sources":["../src/server.ts","../src/config.ts","../src/lib/errors.ts","../src/lib/logger.ts","../src/version.ts","../src/lib/http.ts","../src/lib/rateLimit.ts","../src/lib/cache.ts","../src/format.ts","../src/clients/storefront.ts","../src/clients/web.ts","../src/tools/storefront.ts","../src/lib/result.ts","../src/tools/guard.ts","../src/tools/web.ts","../src/index.ts"],"sourcesContent":["// Server construction and stdio startup. Kept separate from the bin entry\n// (index.ts) so tests can import buildServer without triggering startup.\nimport { McpServer } from \"@modelcontextprotocol/sdk/server/mcp.js\";\nimport { StdioServerTransport } from \"@modelcontextprotocol/sdk/server/stdio.js\";\nimport { loadConfig, type Config } from \"./config.js\";\nimport { createLogger, type Logger } from \"./lib/logger.js\";\nimport { StorefrontClient } from \"./clients/storefront.js\";\nimport { SteamWebClient } from \"./clients/web.js\";\nimport { registerStorefrontTools } from \"./tools/storefront.js\";\nimport { registerWebTools } from \"./tools/web.js\";\nimport { VERSION } from \"./version.js\";\n\nconst INSTRUCTIONS =\n \"Query Steam games and players. Store data needs no key: search_games → get_game / \" +\n \"get_game_reviews for details, get_specials / get_featured / discover_deals for what's on sale \" +\n \"(discover_deals finds all catalog discounts by min %, with review % included), get_items to \" +\n \"price- and rating-check a list of appids in one call, get_game_news and get_global_achievements \" +\n \"for a game's news and achievement rarity, get_current_players for live player counts. Player \" +\n \"data needs a free Steam Web API key (STEAM_API_KEY): get_player_summary, get_owned_games, \" +\n \"get_recently_played and get_player_achievements take a 17-digit SteamID64 — use resolve_vanity_url \" +\n \"to convert a custom profile name first, and note the target profile must be public. Tools that \" +\n \"need the key report clearly when it is unset.\";\n\n/** Construct a fully-registered MCP server. Shared by start() and tests. */\nexport function buildServer(config: Config, logger: Logger): McpServer {\n const store = new StorefrontClient(config, logger);\n const web = new SteamWebClient(config, logger);\n\n const server = new McpServer(\n { name: \"steam-games-mcp\", version: VERSION },\n { instructions: INSTRUCTIONS },\n );\n\n registerStorefrontTools(server, store);\n registerWebTools(server, web);\n return server;\n}\n\n/** Load config, build the server, and serve over stdio until terminated. */\nexport async function start(): Promise<void> {\n const config = loadConfig();\n const logger = createLogger(config.logLevel);\n const server = buildServer(config, logger);\n\n await server.connect(new StdioServerTransport());\n logger.info(`steam-games-mcp ${VERSION} ready`);\n\n const shutdown = (signal: string): void => {\n logger.info(`received ${signal}, shutting down`);\n void server.close().finally(() => process.exit(0));\n };\n process.on(\"SIGINT\", () => shutdown(\"SIGINT\"));\n process.on(\"SIGTERM\", () => shutdown(\"SIGTERM\"));\n process.on(\"unhandledRejection\", (reason) => logger.error(\"unhandled rejection\", reason));\n process.on(\"uncaughtException\", (err) => {\n logger.error(\"uncaught exception\", err);\n process.exit(1);\n });\n}\n","// Loads and validates configuration from environment variables. Two upstreams:\n// the Steam Storefront API (game/store data — no key) and the official Steam\n// Web API (player profiles, library, achievements — needs a free key from\n// https://steamcommunity.com/dev/apikey). The key is optional so the server\n// always starts and the store + keyless tools work; player tools report a clear\n// error at call time when it is missing. Empty strings are treated as unset so\n// .mcpb (which passes \"\" for unconfigured user_config fields) does not crash.\nimport { z } from \"zod\";\nimport type { LogLevel } from \"./lib/logger.js\";\n\nconst EnvSchema = z.object({\n // --- Steam Web API: free key (player data). https://steamcommunity.com/dev/apikey\n STEAM_API_KEY: z.string().min(1).optional(),\n STEAM_API_BASE_URL: z.string().url().default(\"https://api.steampowered.com\"),\n // --- Steam Storefront API: no key; game/store data. ---\n STEAM_STORE_BASE_URL: z.string().url().default(\"https://store.steampowered.com\"),\n\n // Storefront is region/locale-aware: cc = ISO country (prices), l = language.\n STEAM_COUNTRY: z.string().min(2).max(2).default(\"US\"),\n STEAM_LANGUAGE: z.string().min(2).default(\"english\"),\n\n // --- Generic tunables. ---\n HTTP_TIMEOUT_MS: z.coerce.number().int().positive().default(15000),\n HTTP_RETRIES: z.coerce.number().int().nonnegative().default(2),\n // The Storefront API is unofficial and rate-sensitive to bursts, so space its\n // calls; the Web API allows ~100k/day and needs little throttling. 0 disables.\n STEAM_STORE_MIN_INTERVAL_MS: z.coerce.number().int().nonnegative().default(250),\n STEAM_API_MIN_INTERVAL_MS: z.coerce.number().int().nonnegative().default(0),\n CACHE_TTL_MS: z.coerce.number().int().nonnegative().default(300_000),\n\n LOG_LEVEL: z.enum([\"debug\", \"info\", \"warn\", \"error\", \"silent\"]).default(\"info\"),\n});\n\nexport interface Config {\n steamApiBaseUrl: string;\n steamApiKey: string | undefined;\n steamStoreBaseUrl: string;\n country: string;\n language: string;\n httpTimeoutMs: number;\n httpRetries: number;\n storeMinIntervalMs: number;\n apiMinIntervalMs: number;\n cacheTtlMs: number;\n logLevel: LogLevel;\n}\n\nexport function loadConfig(env: NodeJS.ProcessEnv = process.env): Config {\n // Drop empty-string values so defaults apply and the optional key stays unset.\n const cleaned = Object.fromEntries(\n Object.entries(env).filter(([, v]) => v !== undefined && v !== \"\"),\n );\n const parsed = EnvSchema.parse(cleaned);\n\n return {\n steamApiBaseUrl: parsed.STEAM_API_BASE_URL,\n steamApiKey: parsed.STEAM_API_KEY,\n steamStoreBaseUrl: parsed.STEAM_STORE_BASE_URL,\n country: parsed.STEAM_COUNTRY,\n language: parsed.STEAM_LANGUAGE,\n httpTimeoutMs: parsed.HTTP_TIMEOUT_MS,\n httpRetries: parsed.HTTP_RETRIES,\n storeMinIntervalMs: parsed.STEAM_STORE_MIN_INTERVAL_MS,\n apiMinIntervalMs: parsed.STEAM_API_MIN_INTERVAL_MS,\n cacheTtlMs: parsed.CACHE_TTL_MS,\n logLevel: parsed.LOG_LEVEL,\n };\n}\n","// Typed errors for upstream API failures. Clients throw `ApiError`; tool\n// handlers convert it into an MCP tool result (see lib/result.ts) so the\n// agent gets an actionable, non-protocol error.\n\nexport type ApiErrorCode =\n | \"unauthorized\" // 401 — token missing/expired/invalid\n | \"forbidden\" // 403 — insufficient permissions/scope\n | \"not_found\" // 404 — no such resource\n | \"not_modified\" // 304 — cached content still fresh (conditional request)\n | \"rate_limited\" // 429 — slow down\n | \"server_error\" // 5xx — upstream broke\n | \"network\" // connection failed\n | \"timeout\" // request aborted by our timeout\n | \"bad_request\" // 400/405/422 — malformed or unsupported request\n | \"unknown\";\n\nexport interface ApiErrorOptions {\n code: ApiErrorCode;\n message: string;\n status?: number;\n retryable?: boolean;\n cause?: unknown;\n}\n\nexport class ApiError extends Error {\n readonly code: ApiErrorCode;\n readonly status: number | undefined;\n readonly retryable: boolean;\n\n constructor(opts: ApiErrorOptions) {\n super(opts.message, opts.cause === undefined ? undefined : { cause: opts.cause });\n this.name = \"ApiError\";\n this.code = opts.code;\n this.status = opts.status;\n this.retryable = opts.retryable ?? false;\n }\n}\n\n/** Map an HTTP status code to an ApiErrorCode and whether a retry may help. */\nexport function classifyStatus(status: number): { code: ApiErrorCode; retryable: boolean } {\n if (status === 304) return { code: \"not_modified\", retryable: false };\n if (status === 401) return { code: \"unauthorized\", retryable: false };\n if (status === 403) return { code: \"forbidden\", retryable: false };\n if (status === 404) return { code: \"not_found\", retryable: false };\n if (status === 429) return { code: \"rate_limited\", retryable: true };\n if (status === 400 || status === 405 || status === 422)\n return { code: \"bad_request\", retryable: false };\n if (status >= 500) return { code: \"server_error\", retryable: true };\n return { code: \"unknown\", retryable: false };\n}\n\n/** Strip anything that looks like a credential before logging. */\nexport function redact(input: string): string {\n return input\n .replace(/Bearer\\s+[A-Za-z0-9._~+/-]+=*/gi, \"Bearer ***\")\n .replace(/\\b(access_token|refresh_token|client_secret|client_id)=([^&\\s\"]+)/gi, \"$1=***\");\n}\n","// Minimal leveled logger. Writes to stderr ONLY — stdout is reserved for the\n// MCP stdio protocol. All messages are redacted of credentials.\nimport { redact } from \"./errors.js\";\n\nexport type LogLevel = \"debug\" | \"info\" | \"warn\" | \"error\" | \"silent\";\n\nconst ORDER: Record<LogLevel, number> = {\n debug: 10,\n info: 20,\n warn: 30,\n error: 40,\n silent: 100,\n};\n\nexport interface Logger {\n debug(msg: string, ...args: unknown[]): void;\n info(msg: string, ...args: unknown[]): void;\n warn(msg: string, ...args: unknown[]): void;\n error(msg: string, ...args: unknown[]): void;\n}\n\nexport function createLogger(level: LogLevel): Logger {\n const threshold = ORDER[level];\n\n function emit(lvl: Exclude<LogLevel, \"silent\">, msg: string, args: unknown[]): void {\n if (ORDER[lvl] < threshold) return;\n const extra = args.length ? \" \" + redact(args.map((a) => safeString(a)).join(\" \")) : \"\";\n console.error(`[mal-mcp] ${lvl}: ${redact(msg)}${extra}`);\n }\n\n return {\n debug: (m, ...a) => emit(\"debug\", m, a),\n info: (m, ...a) => emit(\"info\", m, a),\n warn: (m, ...a) => emit(\"warn\", m, a),\n error: (m, ...a) => emit(\"error\", m, a),\n };\n}\n\nfunction safeString(value: unknown): string {\n if (typeof value === \"string\") return value;\n if (value instanceof Error) return value.message;\n try {\n return JSON.stringify(value);\n } catch {\n return String(value);\n }\n}\n","// Kept in sync with package.json by a unit test (see __tests__/version.test.ts).\nexport const VERSION = \"0.2.0\";\n\nexport const USER_AGENT = `steam-games-mcp/${VERSION} (+https://github.com/Grinv/steam-games-mcp)`;\n","// Thin fetch wrapper shared by both API clients: timeouts, bounded retries\n// with exponential backoff (honoring Retry-After), a default User-Agent, and\n// uniform mapping of failures to ApiError.\nimport { ApiError, classifyStatus } from \"./errors.js\";\nimport type { Logger } from \"./logger.js\";\nimport { USER_AGENT } from \"../version.js\";\n\nexport interface RequestOptions {\n method?: string;\n headers?: Record<string, string>;\n /** Already-serialized request body (e.g. URLSearchParams string or JSON). */\n body?: string;\n query?: Record<string, string | number | boolean | undefined>;\n timeoutMs?: number;\n /** Max retry attempts for retryable failures (network/timeout/5xx/429). */\n retries?: number;\n signal?: AbortSignal;\n}\n\nexport interface HttpClientOptions {\n baseUrl: string;\n logger: Logger;\n defaultHeaders?: Record<string, string>;\n timeoutMs?: number;\n retries?: number;\n /** Called before each request; lets callers throttle (rate limiting). */\n beforeRequest?: () => Promise<void> | void;\n}\n\nconst MAX_BACKOFF_MS = 8000;\n\nexport class HttpClient {\n readonly #opts: HttpClientOptions;\n\n constructor(opts: HttpClientOptions) {\n this.#opts = opts;\n }\n\n async getJson<T>(path: string, options: RequestOptions = {}): Promise<T> {\n return this.requestJson<T>(path, { ...options, method: options.method ?? \"GET\" });\n }\n\n async requestJson<T>(path: string, options: RequestOptions = {}): Promise<T> {\n const url = this.#buildUrl(path, options.query);\n const retries = options.retries ?? this.#opts.retries ?? 2;\n const timeoutMs = options.timeoutMs ?? this.#opts.timeoutMs ?? 15000;\n\n let attempt = 0;\n for (;;) {\n if (this.#opts.beforeRequest) await this.#opts.beforeRequest();\n try {\n return await this.#once<T>(url, options, timeoutMs);\n } catch (err) {\n const apiErr = err instanceof ApiError ? err : toNetworkError(err);\n if (!apiErr.retryable || attempt >= retries) throw apiErr;\n const backoff = backoffMs(attempt, apiErr);\n this.#opts.logger.debug(\n `retrying ${url} after ${backoff}ms (attempt ${attempt + 1}/${retries}, ${apiErr.code})`,\n );\n await delay(backoff);\n attempt += 1;\n }\n }\n }\n\n async #once<T>(url: string, options: RequestOptions, timeoutMs: number): Promise<T> {\n const controller = new AbortController();\n const timer = setTimeout(() => controller.abort(), timeoutMs);\n const onAbort = () => controller.abort();\n options.signal?.addEventListener(\"abort\", onAbort, { once: true });\n\n let res: Response;\n try {\n res = await fetch(url, {\n method: options.method ?? \"GET\",\n headers: {\n \"User-Agent\": USER_AGENT,\n Accept: \"application/json\",\n ...this.#opts.defaultHeaders,\n ...options.headers,\n },\n ...(options.body === undefined ? {} : { body: options.body }),\n signal: controller.signal,\n });\n } catch (err) {\n if (options.signal?.aborted) {\n // Caller cancelled — propagate as a non-retryable abort.\n throw new ApiError({ code: \"network\", message: \"Request aborted by caller\", cause: err });\n }\n if (controller.signal.aborted) {\n throw new ApiError({\n code: \"timeout\",\n message: `Request timed out after ${timeoutMs}ms`,\n retryable: true,\n cause: err,\n });\n }\n throw toNetworkError(err);\n } finally {\n clearTimeout(timer);\n options.signal?.removeEventListener(\"abort\", onAbort);\n }\n\n if (!res.ok) throw await toHttpError(res);\n\n if (res.status === 204) return undefined as T;\n const text = await res.text();\n if (text.length === 0) return undefined as T;\n try {\n return JSON.parse(text) as T;\n } catch (err) {\n throw new ApiError({\n code: \"unknown\",\n message: \"Upstream returned invalid JSON\",\n cause: err,\n });\n }\n }\n\n #buildUrl(path: string, query?: RequestOptions[\"query\"]): string {\n const url = new URL(path.replace(/^\\//, \"\"), ensureTrailingSlash(this.#opts.baseUrl));\n if (query) {\n for (const [key, value] of Object.entries(query)) {\n if (value !== undefined) url.searchParams.set(key, String(value));\n }\n }\n return url.toString();\n }\n}\n\nasync function toHttpError(res: Response): Promise<ApiError> {\n const { code, retryable } = classifyStatus(res.status);\n let raw = \"\";\n try {\n raw = await res.text();\n } catch {\n /* ignore body read errors */\n }\n // Prefer a structured `message`/`error` field; fall back to the raw body.\n const detail = parseErrorMessage(raw) ?? raw.slice(0, 500);\n const retryAfter = parseRetryAfter(res.headers.get(\"retry-after\"));\n return new ApiError({\n code,\n status: res.status,\n retryable,\n message: `HTTP ${res.status} ${res.statusText}${detail ? `: ${detail}` : \"\"}`,\n ...(retryAfter === undefined ? {} : { cause: { retryAfterMs: retryAfter } }),\n });\n}\n\n// Many JSON APIs return an error envelope like { message } or { error }.\nfunction parseErrorMessage(raw: string): string | undefined {\n if (!raw) return undefined;\n try {\n const obj: unknown = JSON.parse(raw);\n if (obj === null || typeof obj !== \"object\") return undefined;\n const rec = obj as Record<string, unknown>;\n if (typeof rec.message === \"string\") return rec.message;\n if (typeof rec.error === \"string\") return rec.error;\n return undefined;\n } catch {\n return undefined; // not JSON — caller falls back to the raw body\n }\n}\n\nfunction toNetworkError(err: unknown): ApiError {\n if (err instanceof ApiError) return err;\n return new ApiError({\n code: \"network\",\n message: err instanceof Error ? `Network error: ${err.message}` : \"Network error\",\n retryable: true,\n cause: err,\n });\n}\n\nfunction backoffMs(attempt: number, err: ApiError): number {\n const hinted = (err.cause as { retryAfterMs?: number } | undefined)?.retryAfterMs;\n if (typeof hinted === \"number\" && hinted > 0) return Math.min(hinted, MAX_BACKOFF_MS);\n const base = Math.min(MAX_BACKOFF_MS, 500 * 2 ** attempt);\n return base + Math.floor(base * 0.25 * deterministicJitter(attempt));\n}\n\n// Jitter without Math.random: small deterministic spread by attempt index.\nfunction deterministicJitter(attempt: number): number {\n return ((attempt * 2654435761) % 1000) / 1000;\n}\n\nfunction parseRetryAfter(header: string | null): number | undefined {\n if (!header) return undefined;\n const seconds = Number(header);\n if (Number.isFinite(seconds)) return seconds * 1000;\n const date = Date.parse(header);\n if (Number.isFinite(date)) return Math.max(0, date - Date.now());\n return undefined;\n}\n\nfunction ensureTrailingSlash(s: string): string {\n return s.endsWith(\"/\") ? s : s + \"/\";\n}\n\nfunction delay(ms: number): Promise<void> {\n return new Promise((resolve) => setTimeout(resolve, ms));\n}\n","// Serializes calls and spaces them to respect both a minimum interval and any\n// number of sliding-window limits (e.g. an upstream that allows N req/s AND\n// M req/min). A single min-interval can satisfy a per-second cap but not a\n// sustained per-minute one, so the window rules are what keep sustained traffic\n// under the published ceiling.\n//\n// Acquisitions are ordered through a tail-promise chain, so only one runs at a\n// time and the window bookkeeping stays consistent. In-flight network time still\n// overlaps because acquire() resolves before the request itself runs.\n\nexport interface RateRule {\n /** Max granted acquisitions allowed within any `windowMs` span. */\n limit: number;\n windowMs: number;\n}\n\nexport class RateLimiter {\n readonly #minIntervalMs: number;\n readonly #rules: RateRule[];\n readonly #maxWindowMs: number;\n // Ascending timestamps of granted acquisitions, pruned to the largest window.\n readonly #history: number[] = [];\n #tail: Promise<void> = Promise.resolve();\n #lastStart = 0;\n\n constructor(minIntervalMs: number, rules: RateRule[] = []) {\n this.#minIntervalMs = Math.max(0, minIntervalMs);\n this.#rules = rules;\n this.#maxWindowMs = rules.reduce((max, r) => Math.max(max, r.windowMs), 0);\n }\n\n /** Resolves when the caller is allowed to proceed. */\n acquire(): Promise<void> {\n const prev = this.#tail;\n let release!: () => void;\n this.#tail = new Promise<void>((resolve) => {\n release = resolve;\n });\n\n return prev.then(async () => {\n const wait = this.#delayUntilAllowed();\n if (wait > 0) await delay(wait);\n const now = Date.now();\n this.#lastStart = now;\n this.#record(now);\n // Release the next waiter's gate; the spacing above keeps them in line.\n release();\n });\n }\n\n /** Earliest delay (ms) before another acquisition stays within every limit. */\n #delayUntilAllowed(): number {\n const now = Date.now();\n let until = this.#lastStart + this.#minIntervalMs;\n for (const rule of this.#rules) {\n if (this.#history.length < rule.limit) continue;\n // Once the `limit`-th most recent request leaves the window, there is\n // room for one more. Stale entries land in the past and drop out via max.\n const nth = this.#history[this.#history.length - rule.limit]!;\n until = Math.max(until, nth + rule.windowMs);\n }\n return Math.max(0, until - now);\n }\n\n #record(ts: number): void {\n this.#history.push(ts);\n const cutoff = ts - this.#maxWindowMs;\n let stale = 0;\n while (stale < this.#history.length && this.#history[stale]! <= cutoff) stale += 1;\n if (stale > 0) this.#history.splice(0, stale);\n }\n}\n\nfunction delay(ms: number): Promise<void> {\n return new Promise((resolve) => setTimeout(resolve, ms));\n}\n","// Tiny in-memory TTL cache for read endpoints. Caching cuts latency and eases\n// pressure on rate-limited upstreams. Expired entries are retained (bounded by\n// max size) so they can be served as a stale fallback when the upstream is down.\n\ninterface Entry<T> {\n value: T;\n expires: number;\n}\n\nexport class TtlCache<T> {\n readonly #ttlMs: number;\n readonly #max: number;\n readonly #map = new Map<string, Entry<T>>();\n\n constructor(ttlMs: number, max = 500) {\n this.#ttlMs = ttlMs;\n this.#max = max;\n }\n\n /** Fresh (non-expired) value, or undefined. */\n get(key: string): T | undefined {\n const hit = this.#map.get(key);\n if (!hit) return undefined;\n return hit.expires > Date.now() ? hit.value : undefined;\n }\n\n /** Any cached value regardless of freshness — used for stale fallback. */\n getStale(key: string): T | undefined {\n return this.#map.get(key)?.value;\n }\n\n set(key: string, value: T): void {\n if (this.#ttlMs <= 0) return;\n if (!this.#map.has(key) && this.#map.size >= this.#max) {\n const oldest = this.#map.keys().next().value;\n if (oldest !== undefined) this.#map.delete(oldest);\n }\n this.#map.set(key, { value, expires: Date.now() + this.#ttlMs });\n }\n\n /** Get-or-compute, caching the resolved value. */\n async wrap(key: string, compute: () => Promise<T>): Promise<T> {\n const cached = this.get(key);\n if (cached !== undefined) return cached;\n const value = await compute();\n this.set(key, value);\n return value;\n }\n\n /**\n * Like wrap, but if `compute` throws and a previously-cached (possibly stale)\n * value exists, serve that instead of failing. Lets reads degrade gracefully\n * when the upstream is temporarily down.\n */\n async wrapStaleOnError(key: string, compute: () => Promise<T>): Promise<T> {\n const fresh = this.get(key);\n if (fresh !== undefined) return fresh;\n try {\n const value = await compute();\n this.set(key, value);\n return value;\n } catch (err) {\n const stale = this.getStale(key);\n if (stale !== undefined) return stale;\n throw err;\n }\n }\n}\n","// Trims verbose Steam payloads down to the fields an agent needs, keeping tool\n// responses token-efficient. Clients fetch + cache; all raw→agent-facing shaping\n// lives here. Two upstreams: the Storefront API (store data) and the official\n// Web API (player data).\n\nfunction names(list: { description?: string; name?: string }[] | undefined): string[] {\n return (list ?? []).map((x) => x.description ?? x.name).filter((n): n is string => Boolean(n));\n}\n\n// Steam stores playtime in minutes; expose hours (1dp) which agents reason about.\nfunction hours(minutes: number | undefined): number | null {\n return typeof minutes === \"number\" ? Math.round((minutes / 60) * 10) / 10 : null;\n}\n\n// Strip HTML tags from store descriptions / requirements blobs.\nfunction stripHtml(s: string | undefined): string | null {\n if (!s) return null;\n return (\n s\n .replace(/<[^>]+>/g, \" \")\n .replace(/\\s+/g, \" \")\n .trim() || null\n );\n}\n\n// ---- Storefront: appdetails -------------------------------------------------\n\ninterface PriceOverview {\n currency?: string;\n initial?: number;\n final?: number;\n discount_percent?: number;\n initial_formatted?: string;\n final_formatted?: string;\n}\nexport interface StoreApp {\n type?: string;\n name?: string;\n steam_appid?: number;\n is_free?: boolean;\n short_description?: string;\n detailed_description?: string;\n about_the_game?: string;\n supported_languages?: string;\n header_image?: string;\n website?: string | null;\n developers?: string[];\n publishers?: string[];\n price_overview?: PriceOverview;\n platforms?: { windows?: boolean; mac?: boolean; linux?: boolean };\n metacritic?: { score?: number; url?: string };\n categories?: { id?: number; description?: string }[];\n genres?: { id?: string; description?: string }[];\n release_date?: { coming_soon?: boolean; date?: string };\n recommendations?: { total?: number };\n pc_requirements?: { minimum?: string; recommended?: string } | [];\n required_age?: number | string;\n dlc?: number[];\n achievements?: { total?: number; highlighted?: { name?: string; path?: string }[] };\n controller_support?: string;\n content_descriptors?: { ids?: number[]; notes?: string | null };\n fullgame?: { appid?: string; name?: string };\n demos?: { appid?: number; description?: string }[];\n drm_notice?: string;\n ext_user_account_notice?: string;\n}\n\nfunction price(\n p: PriceOverview | undefined,\n isFree: boolean | undefined,\n): Record<string, unknown> | null {\n if (isFree) return { is_free: true };\n if (!p) return null;\n return {\n is_free: false,\n currency: p.currency ?? null,\n final: p.final_formatted ?? null,\n // Steam leaves initial_formatted empty when there's no discount.\n initial: p.initial_formatted || p.final_formatted || null,\n discount_percent: p.discount_percent ?? 0,\n };\n}\n\nfunction platforms(p: StoreApp[\"platforms\"]): string[] {\n if (!p) return [];\n return Object.entries(p)\n .filter(([, on]) => on)\n .map(([os]) => os);\n}\n\nexport function detailApp(a: StoreApp): Record<string, unknown> {\n const reqs = Array.isArray(a.pc_requirements) ? undefined : a.pc_requirements;\n return {\n appid: a.steam_appid,\n name: a.name,\n type: a.type ?? null,\n short_description: a.short_description || null,\n is_free: a.is_free ?? false,\n price: price(a.price_overview, a.is_free),\n release_date: a.release_date?.date || null,\n coming_soon: a.release_date?.coming_soon ?? false,\n developers: a.developers ?? [],\n publishers: a.publishers ?? [],\n genres: names(a.genres),\n categories: names(a.categories),\n platforms: platforms(a.platforms),\n metacritic: a.metacritic?.score ?? null,\n metacritic_url: a.metacritic?.url ?? null,\n recommendations: a.recommendations?.total ?? null,\n required_age: a.required_age ?? null,\n controller_support: a.controller_support ?? null,\n achievements_total: a.achievements?.total ?? null,\n // A keyless sample of named achievements; use get_game_achievements for all.\n achievements_highlighted: (a.achievements?.highlighted ?? [])\n .map((h) => h.name)\n .filter((n): n is string => Boolean(n)),\n supported_languages: stripHtml(a.supported_languages),\n dlc: a.dlc ?? [],\n demos: (a.demos ?? []).map((d) => d.appid).filter(Boolean),\n // Content descriptor ids flag mature themes (violence/nudity/etc.); notes\n // is Valve's free-text. Empty ids → no mature descriptors.\n content_descriptors: {\n ids: a.content_descriptors?.ids ?? [],\n notes: a.content_descriptors?.notes ?? null,\n },\n // Present only for DLC: the base game it belongs to.\n base_game: a.fullgame?.appid\n ? { appid: Number(a.fullgame.appid), name: a.fullgame.name ?? null }\n : null,\n drm_notice: a.drm_notice || null,\n account_notice: a.ext_user_account_notice || null,\n pc_requirements_min: stripHtml(reqs?.minimum),\n website: a.website || null,\n header_image: a.header_image || null,\n store_url: a.steam_appid ? `https://store.steampowered.com/app/${a.steam_appid}` : null,\n };\n}\n\n// ---- Storefront: storesearch ------------------------------------------------\n\ninterface SearchItem {\n type?: string;\n name?: string;\n id?: number;\n price?: { currency?: string; initial?: number; final?: number };\n tiny_image?: string;\n metascore?: string;\n platforms?: { windows?: boolean; mac?: boolean; linux?: boolean };\n}\nexport interface SearchResponse {\n total?: number;\n items?: SearchItem[];\n}\n\n// storesearch prices are raw cents (initial/final); derive a discount + labels.\nfunction searchPrice(p: SearchItem[\"price\"]): Record<string, unknown> | null {\n if (!p || typeof p.final !== \"number\") return null;\n const discount =\n p.initial && p.final && p.initial > p.final ? Math.round((1 - p.final / p.initial) * 100) : 0;\n return {\n currency: p.currency ?? null,\n final: money(p.final, p.currency),\n initial: money(p.initial, p.currency),\n discount_percent: discount,\n };\n}\n\nexport function summarizeSearch(r: SearchResponse): Record<string, unknown> {\n return {\n total: r.total ?? r.items?.length ?? 0,\n results: (r.items ?? []).map((i) => ({\n appid: i.id,\n name: i.name,\n type: i.type ?? null,\n price: searchPrice(i.price),\n metascore: i.metascore || null,\n platforms: platforms(i.platforms),\n store_url: i.id ? `https://store.steampowered.com/app/${i.id}` : null,\n })),\n };\n}\n\n// ---- Storefront: batch prices (appdetails?filters=price_overview) -----------\n\n// appdetails keyed by appid; with the price_overview filter, `data` is either\n// { price_overview } or an empty array (free / no price).\nexport type PriceDetailsResponse = Record<\n string,\n { success?: boolean; data?: { price_overview?: PriceOverview } | [] }\n>;\n\n// Shape a merged batch response into one row per requested appid, preserving\n// order. Missing/free entries come back with is_free:true and no numbers.\nexport function summarizePrices(\n merged: PriceDetailsResponse,\n appids: number[],\n): Record<string, unknown> {\n const prices = appids.map((id) => {\n const entry = merged[String(id)];\n const data = entry?.data;\n const po = data && !Array.isArray(data) ? data.price_overview : undefined;\n if (!entry?.success) return { appid: id, available: false };\n if (!po) return { appid: id, available: true, is_free: true };\n return {\n appid: id,\n available: true,\n is_free: false,\n currency: po.currency ?? null,\n final: po.final_formatted ?? null,\n initial: po.initial_formatted || po.final_formatted || null,\n discount_percent: po.discount_percent ?? 0,\n };\n });\n return { count: prices.length, prices };\n}\n\n// ---- Storefront: appreviews -------------------------------------------------\n\nexport interface ReviewsResponse {\n success?: number;\n query_summary?: {\n num_reviews?: number;\n review_score?: number;\n review_score_desc?: string;\n total_positive?: number;\n total_negative?: number;\n total_reviews?: number;\n };\n reviews?: {\n review?: string;\n voted_up?: boolean;\n votes_up?: number;\n timestamp_created?: number;\n author?: { playtime_forever?: number };\n }[];\n}\n\nexport function summarizeReviews(r: ReviewsResponse, max = 5): Record<string, unknown> {\n const q = r.query_summary ?? {};\n return {\n summary: q.review_score_desc ?? null,\n total_reviews: q.total_reviews ?? null,\n total_positive: q.total_positive ?? null,\n total_negative: q.total_negative ?? null,\n positive_pct:\n q.total_reviews && q.total_positive\n ? Math.round((q.total_positive / q.total_reviews) * 100)\n : null,\n reviews: (r.reviews ?? []).slice(0, max).map((x) => ({\n voted_up: x.voted_up ?? null,\n votes_up: x.votes_up ?? 0,\n author_playtime_hours: hours(x.author?.playtime_forever),\n text: x.review ? (x.review.length > 600 ? x.review.slice(0, 600) + \"…\" : x.review) : null,\n })),\n };\n}\n\n// ---- Storefront: featuredcategories -----------------------------------------\n\ninterface FeaturedItem {\n id?: number;\n name?: string;\n discounted?: boolean;\n discount_percent?: number;\n original_price?: number;\n final_price?: number;\n currency?: string;\n}\nexport interface FeaturedResponse {\n specials?: { items?: FeaturedItem[] };\n top_sellers?: { items?: FeaturedItem[] };\n new_releases?: { items?: FeaturedItem[] };\n coming_soon?: { items?: FeaturedItem[] };\n}\n\nfunction money(cents: number | undefined, currency: string | undefined): string | null {\n if (typeof cents !== \"number\") return null;\n const v = (cents / 100).toFixed(2);\n return currency ? `${v} ${currency}` : v;\n}\n\nfunction featuredItems(items: FeaturedItem[] | undefined): Record<string, unknown>[] {\n return (items ?? []).map((i) => ({\n appid: i.id,\n name: i.name,\n discounted: i.discounted ?? false,\n discount_percent: i.discount_percent ?? 0,\n original_price: money(i.original_price, i.currency),\n final_price: money(i.final_price, i.currency),\n store_url: i.id ? `https://store.steampowered.com/app/${i.id}` : null,\n }));\n}\n\nexport function summarizeFeatured(r: FeaturedResponse): Record<string, unknown> {\n return {\n specials: featuredItems(r.specials?.items),\n top_sellers: featuredItems(r.top_sellers?.items),\n new_releases: featuredItems(r.new_releases?.items),\n coming_soon: featuredItems(r.coming_soon?.items),\n };\n}\n\nexport function summarizeSpecials(r: FeaturedResponse): Record<string, unknown> {\n return { specials: featuredItems(r.specials?.items) };\n}\n\n// ---- Web API: player summary ------------------------------------------------\n\ninterface PlayerSummary {\n steamid?: string;\n personaname?: string;\n profileurl?: string;\n avatarfull?: string;\n personastate?: number;\n realname?: string;\n loccountrycode?: string;\n timecreated?: number;\n communityvisibilitystate?: number;\n gameextrainfo?: string;\n gameid?: string;\n}\nexport interface PlayerSummariesResponse {\n response?: { players?: PlayerSummary[] };\n}\n\nconst PERSONA_STATES = [\n \"offline\",\n \"online\",\n \"busy\",\n \"away\",\n \"snooze\",\n \"looking to trade\",\n \"looking to play\",\n];\n\nexport function summarizePlayer(r: PlayerSummariesResponse): Record<string, unknown> {\n const p = r.response?.players?.[0];\n if (!p) return { found: false };\n return {\n found: true,\n steamid: p.steamid,\n name: p.personaname ?? null,\n real_name: p.realname || null,\n state: PERSONA_STATES[p.personastate ?? 0] ?? \"offline\",\n visibility: p.communityvisibilitystate === 3 ? \"public\" : \"private\",\n country: p.loccountrycode || null,\n created: p.timecreated ? new Date(p.timecreated * 1000).toISOString().slice(0, 10) : null,\n in_game: p.gameextrainfo || null,\n profile_url: p.profileurl ?? null,\n avatar: p.avatarfull ?? null,\n };\n}\n\n// ---- Web API: owned / recently played ---------------------------------------\n\ninterface OwnedGame {\n appid?: number;\n name?: string;\n playtime_forever?: number;\n playtime_2weeks?: number;\n img_icon_url?: string;\n}\nexport interface OwnedGamesResponse {\n response?: { game_count?: number; games?: OwnedGame[] };\n}\n\n// Steam returns an empty `response: {}` (no game_count) when the profile or its\n// game-details are private — distinct from a public account with 0 games.\nconst PRIVATE_REASON =\n \"Profile or game-details are private. Ask the owner to set Steam → Privacy → \" +\n \"Game details = Public, or this data can't be read.\";\n\nfunction isPrivate(r: OwnedGamesResponse): boolean {\n return r.response?.game_count === undefined && r.response?.games === undefined;\n}\n\n// Sort by playtime desc and cap; a big library would otherwise blow the budget.\nexport function summarizeOwnedGames(r: OwnedGamesResponse, max = 50): Record<string, unknown> {\n if (isPrivate(r)) return { found: false, reason: PRIVATE_REASON, game_count: null, games: [] };\n const games = (r.response?.games ?? [])\n .slice()\n .sort((a, b) => (b.playtime_forever ?? 0) - (a.playtime_forever ?? 0));\n return {\n found: true,\n game_count: r.response?.game_count ?? games.length,\n returned: Math.min(games.length, max),\n games: games.slice(0, max).map((g) => ({\n appid: g.appid,\n name: g.name ?? null,\n playtime_hours: hours(g.playtime_forever),\n playtime_2weeks_hours: hours(g.playtime_2weeks),\n })),\n };\n}\n\nexport function summarizeRecentlyPlayed(r: OwnedGamesResponse): Record<string, unknown> {\n if (isPrivate(r)) return { found: false, reason: PRIVATE_REASON, total: 0, games: [] };\n return {\n found: true,\n total: r.response?.game_count ?? r.response?.games?.length ?? 0,\n games: (r.response?.games ?? []).map((g) => ({\n appid: g.appid,\n name: g.name ?? null,\n playtime_2weeks_hours: hours(g.playtime_2weeks),\n playtime_hours: hours(g.playtime_forever),\n })),\n };\n}\n\n// ---- Web API: player achievements -------------------------------------------\n\nexport interface PlayerAchievementsResponse {\n playerstats?: {\n success?: boolean;\n error?: string;\n gameName?: string;\n achievements?: { apiname?: string; name?: string; achieved?: number; unlocktime?: number }[];\n };\n}\n\nexport function summarizePlayerAchievements(\n r: PlayerAchievementsResponse,\n): Record<string, unknown> {\n const ps = r.playerstats;\n if (!ps?.success) return { found: false, reason: ps?.error ?? \"No achievement stats\" };\n const all = ps.achievements ?? [];\n const unlocked = all.filter((a) => a.achieved === 1);\n return {\n found: true,\n game: ps.gameName ?? null,\n total: all.length,\n unlocked: unlocked.length,\n completion_pct: all.length ? Math.round((unlocked.length / all.length) * 100) : null,\n achievements: all.map((a) => ({\n name: a.name || a.apiname,\n achieved: a.achieved === 1,\n unlocked_at:\n a.achieved === 1 && a.unlocktime\n ? new Date(a.unlocktime * 1000).toISOString().slice(0, 10)\n : null,\n })),\n };\n}\n\n// ---- Web API: global achievement percentages --------------------------------\n\nexport interface GlobalAchievementsResponse {\n achievementpercentages?: { achievements?: { name?: string; percent?: number | string }[] };\n}\n\nexport function summarizeGlobalAchievements(\n r: GlobalAchievementsResponse,\n): Record<string, unknown> {\n const a = r.achievementpercentages?.achievements ?? [];\n return {\n count: a.length,\n achievements: a.map((x) => ({\n name: x.name,\n percent: typeof x.percent === \"string\" ? Number(x.percent) : (x.percent ?? null),\n })),\n };\n}\n\n// ---- Web API: full achievement schema (key) + global rarity merge -----------\n\nexport interface GameSchemaResponse {\n game?: {\n gameName?: string;\n availableGameStats?: {\n achievements?: {\n name?: string; // internal apiname\n displayName?: string;\n description?: string;\n hidden?: number;\n icon?: string;\n }[];\n };\n };\n}\n\n// Merge the full schema (names/descriptions/hidden) with global unlock % (keyed\n// by the internal apiname), so each achievement carries how rare it is.\nexport function summarizeGameSchema(\n schema: GameSchemaResponse,\n global: GlobalAchievementsResponse,\n): Record<string, unknown> {\n const pct = new Map<string, number>();\n for (const x of global.achievementpercentages?.achievements ?? []) {\n if (x.name != null) {\n pct.set(x.name, typeof x.percent === \"string\" ? Number(x.percent) : (x.percent ?? 0));\n }\n }\n const list = schema.game?.availableGameStats?.achievements ?? [];\n return {\n game: schema.game?.gameName ?? null,\n total: list.length,\n achievements: list.map((a) => {\n const p = a.name != null ? pct.get(a.name) : undefined;\n return {\n api_name: a.name,\n name: a.displayName || a.name || null,\n description: a.description || null,\n hidden: a.hidden === 1,\n global_unlock_pct: typeof p === \"number\" ? Math.round(p * 10) / 10 : null,\n };\n }),\n };\n}\n\n// ---- Web API: news ----------------------------------------------------------\n\nexport interface NewsResponse {\n appnews?: {\n newsitems?: {\n gid?: string;\n title?: string;\n url?: string;\n author?: string;\n contents?: string;\n feedlabel?: string;\n date?: number;\n }[];\n };\n}\n\nexport function summarizeNews(r: NewsResponse): Record<string, unknown> {\n return {\n items: (r.appnews?.newsitems ?? []).map((n) => ({\n title: n.title ?? null,\n date: n.date ? new Date(n.date * 1000).toISOString().slice(0, 10) : null,\n author: n.author || null,\n feed: n.feedlabel || null,\n excerpt: stripHtml(n.contents),\n url: n.url ?? null,\n })),\n };\n}\n\n// ---- Web API: resolve vanity url --------------------------------------------\n\nexport interface VanityResponse {\n response?: { success?: number; steamid?: string; message?: string };\n}\n\nexport function summarizeVanity(r: VanityResponse): Record<string, unknown> {\n const v = r.response;\n if (v?.success === 1 && v.steamid) return { found: true, steamid: v.steamid };\n return { found: false, reason: v?.message ?? \"No match for that vanity name\" };\n}\n\n// ---- Web API: current players (keyless) -------------------------------------\n\nexport interface CurrentPlayersResponse {\n response?: { player_count?: number; result?: number };\n}\n\nexport function summarizeCurrentPlayers(\n r: CurrentPlayersResponse,\n appid: number,\n): Record<string, unknown> {\n return { appid, player_count: r.response?.player_count ?? null };\n}\n\n// ---- Web API: wishlist (keyless; needs a public wishlist) -------------------\n\nexport interface WishlistResponse {\n response?: { items?: { appid?: number; priority?: number; date_added?: number }[] };\n}\n\nfunction isoDay(ts: number | undefined): string | null {\n return ts ? new Date(ts * 1000).toISOString().slice(0, 10) : null;\n}\n\n// A wishlist can hold tens of thousands of items; sort by priority (1 = top of\n// the list) and cap. Names aren't included — use get_game per appid for details.\nexport function summarizeWishlist(r: WishlistResponse, max = 100): Record<string, unknown> {\n const items = r.response?.items ?? [];\n if (items.length === 0) {\n return {\n found: false,\n reason: \"Empty wishlist, or the profile/wishlist is private.\",\n total: 0,\n items: [],\n };\n }\n const sorted = items.slice().sort((a, b) => (a.priority ?? 1e9) - (b.priority ?? 1e9));\n return {\n found: true,\n total: items.length,\n returned: Math.min(items.length, max),\n items: sorted.slice(0, max).map((i) => ({\n appid: i.appid,\n priority: i.priority ?? null,\n added: isoDay(i.date_added),\n })),\n };\n}\n\n// ---- Storefront: review histogram -------------------------------------------\n\ninterface Rollup {\n date?: number;\n recommendations_up?: number;\n recommendations_down?: number;\n}\nexport interface ReviewHistogramResponse {\n success?: number;\n results?: { rollup_type?: string; rollups?: Rollup[]; recent?: Rollup[] };\n}\n\nfunction rollup(x: Rollup): Record<string, unknown> {\n const up = x.recommendations_up ?? 0;\n const down = x.recommendations_down ?? 0;\n const total = up + down;\n return {\n date: isoDay(x.date),\n up,\n down,\n positive_pct: total ? Math.round((up / total) * 100) : null,\n };\n}\n\n// `rollups` is the long-term trend (monthly here); `recent` is per-day for the\n// last ~30 days. Cap both so the response stays bounded.\nexport function summarizeReviewHistogram(r: ReviewHistogramResponse): Record<string, unknown> {\n const res = r.results ?? {};\n return {\n rollup_type: res.rollup_type ?? null,\n history: (res.rollups ?? []).slice(-24).map(rollup),\n recent: (res.recent ?? []).slice(-30).map(rollup),\n };\n}\n\n// ---- Steam IStoreBrowseService/GetItems (keyless batch store data) ----------\n\ninterface StoreItem {\n appid?: number;\n name?: string;\n is_free?: boolean;\n best_purchase_option?: {\n formatted_final_price?: string;\n formatted_original_price?: string;\n discount_pct?: number;\n };\n reviews?: {\n summary_filtered?: {\n review_count?: number;\n percent_positive?: number;\n review_score_label?: string;\n };\n };\n release?: { steam_release_date?: number; is_coming_soon?: boolean };\n visible?: boolean;\n}\nexport interface StoreItemsResponse {\n response?: { store_items?: StoreItem[] };\n}\n\n// Compact card from a store item (shared by get_items and discover_deals).\nfunction storeCard(it: StoreItem): Record<string, unknown> {\n const bp = it.best_purchase_option;\n const rev = it.reviews?.summary_filtered;\n return {\n appid: it.appid,\n name: it.name ?? null,\n discount_pct: bp?.discount_pct ?? 0,\n price: bp?.formatted_final_price || null,\n original: bp?.formatted_original_price || bp?.formatted_final_price || null,\n review_percent: rev?.percent_positive ?? null,\n review_count: rev?.review_count ?? null,\n review_label: rev?.review_score_label ?? null,\n release_date: it.release?.steam_release_date\n ? new Date(it.release.steam_release_date * 1000).toISOString().slice(0, 10)\n : null,\n };\n}\n\n// ---- Steam IStoreQueryService/Query (keyless catalog discovery) -------------\n\nexport interface StoreQueryResponse {\n response?: {\n metadata?: { total_matching_records?: number; start?: number; count?: number };\n store_items?: StoreItem[];\n };\n}\n\n// Catalog-wide deal discovery. The server filters by min discount; review\n// thresholds (percent / count) and discount-desc sorting are applied here over\n// the returned page, since the Query API ignores those filters/sorts.\nexport function summarizeDiscover(\n r: StoreQueryResponse,\n opts: { minReview?: number; minReviews?: number },\n): Record<string, unknown> {\n let rows = (r.response?.store_items ?? [])\n .filter((it) => it.visible !== false && typeof it.appid === \"number\")\n .map(storeCard);\n if (typeof opts.minReview === \"number\") {\n rows = rows.filter((x) => ((x.review_percent as number | null) ?? -1) >= opts.minReview!);\n }\n if (typeof opts.minReviews === \"number\") {\n rows = rows.filter((x) => ((x.review_count as number | null) ?? 0) >= opts.minReviews!);\n }\n rows.sort((a, b) => (b.discount_pct as number) - (a.discount_pct as number));\n return {\n total_matching: r.response?.metadata?.total_matching_records ?? null,\n returned: rows.length,\n deals: rows,\n };\n}\n\n// Batch store card per requested appid: price+discount, review %, release date —\n// all from one keyless call. Missing appids come back available:false.\nexport function summarizeItems(r: StoreItemsResponse, appids: number[]): Record<string, unknown> {\n const byId = new Map<number, StoreItem>();\n for (const it of r.response?.store_items ?? [])\n if (typeof it.appid === \"number\") byId.set(it.appid, it);\n return {\n count: appids.length,\n items: appids.map((appid) => {\n const it = byId.get(appid);\n if (!it || (!it.name && !it.best_purchase_option && !it.reviews)) {\n return { appid, available: false };\n }\n const bp = it.best_purchase_option;\n const rev = it.reviews?.summary_filtered;\n return {\n appid,\n name: it.name ?? null,\n is_free: it.is_free ?? false,\n price: bp\n ? {\n final: bp.formatted_final_price || null,\n original: bp.formatted_original_price || bp.formatted_final_price || null,\n discount_pct: bp.discount_pct ?? 0,\n }\n : it.is_free\n ? { is_free: true }\n : null,\n review_percent: rev?.percent_positive ?? null,\n review_count: rev?.review_count ?? null,\n review_label: rev?.review_score_label ?? null,\n release_date: it.release?.steam_release_date\n ? new Date(it.release.steam_release_date * 1000).toISOString().slice(0, 10)\n : null,\n coming_soon: it.release?.is_coming_soon ?? false,\n };\n }),\n };\n}\n","// Read-only client for the Steam Storefront API (store.steampowered.com). This\n// API is unofficial but public and needs no key — it backs all the game/store\n// tools. Region/locale-aware via cc (country) and l (language). Wraps the\n// generic HttpClient with a polite rate limiter (the store is burst-sensitive)\n// and a TTL cache; all shaping lives in ../format.js.\nimport { HttpClient } from \"../lib/http.js\";\nimport { RateLimiter } from \"../lib/rateLimit.js\";\nimport { TtlCache } from \"../lib/cache.js\";\nimport { ApiError } from \"../lib/errors.js\";\nimport {\n detailApp,\n summarizeFeatured,\n summarizePrices,\n summarizeReviewHistogram,\n summarizeReviews,\n summarizeSearch,\n summarizeSpecials,\n type FeaturedResponse,\n type PriceDetailsResponse,\n type ReviewHistogramResponse,\n type ReviewsResponse,\n type SearchResponse,\n type StoreApp,\n} from \"../format.js\";\nimport type { Logger } from \"../lib/logger.js\";\nimport type { Config } from \"../config.js\";\n\ntype AppDetailsResponse = Record<string, { success?: boolean; data?: StoreApp }>;\n\nexport class StorefrontClient {\n readonly #http: HttpClient;\n readonly #cache: TtlCache<Record<string, unknown>>;\n readonly #cc: string;\n readonly #l: string;\n\n constructor(config: Config, logger: Logger) {\n this.#cc = config.country;\n this.#l = config.language;\n const limiter = new RateLimiter(config.storeMinIntervalMs);\n this.#http = new HttpClient({\n baseUrl: config.steamStoreBaseUrl,\n logger,\n timeoutMs: config.httpTimeoutMs,\n retries: config.httpRetries,\n beforeRequest: () => limiter.acquire(),\n });\n this.#cache = new TtlCache(config.cacheTtlMs);\n }\n\n // country (cc) and language (l) fall back to the configured defaults; tools\n // expose them as optional per-call overrides (e.g. compare prices by region).\n async searchGames(\n term: string,\n country?: string,\n language?: string,\n ): Promise<Record<string, unknown>> {\n const res = await this.#http.getJson<SearchResponse>(\"api/storesearch/\", {\n query: { term, l: language ?? this.#l, cc: country ?? this.#cc },\n });\n return summarizeSearch(res);\n }\n\n async getGame(\n appid: number,\n country?: string,\n language?: string,\n ): Promise<Record<string, unknown>> {\n const cc = country ?? this.#cc;\n const l = language ?? this.#l;\n return this.#cache.wrapStaleOnError(`app:${appid}:${cc}:${l}`, async () => {\n const res = await this.#http.getJson<AppDetailsResponse>(\"api/appdetails\", {\n query: { appids: appid, cc, l },\n });\n const entry = res[String(appid)];\n if (!entry?.success || !entry.data) {\n throw new ApiError({ code: \"not_found\", message: `No Steam app with id ${appid}` });\n }\n return detailApp(entry.data);\n });\n }\n\n // Not cached: reviews are paginated and change as users post. `reviewLanguage`\n // filters by review language (\"all\" = any); `reviewType` = all|positive|negative.\n async getReviews(\n appid: number,\n max: number,\n reviewLanguage = \"all\",\n reviewType = \"all\",\n ): Promise<Record<string, unknown>> {\n const res = await this.#http.getJson<ReviewsResponse>(`appreviews/${appid}`, {\n query: {\n json: 1,\n num_per_page: max,\n language: reviewLanguage,\n review_type: reviewType,\n purchase_type: \"all\",\n },\n });\n return summarizeReviews(res, max);\n }\n\n // Batch prices for many appids in one place. appdetails accepts a comma-list\n // with filters=price_overview; we chunk to keep URLs/responses bounded and\n // merge. Not cached — prices change and the appid set varies per call.\n async getPrices(appids: number[], country?: string): Promise<Record<string, unknown>> {\n const cc = country ?? this.#cc;\n const CHUNK = 100;\n const merged: PriceDetailsResponse = {};\n for (let i = 0; i < appids.length; i += CHUNK) {\n const chunk = appids.slice(i, i + CHUNK);\n const res = await this.#http.getJson<PriceDetailsResponse>(\"api/appdetails\", {\n query: { appids: chunk.join(\",\"), cc, filters: \"price_overview\" },\n });\n Object.assign(merged, res);\n }\n return summarizePrices(merged, appids);\n }\n\n // Review trend over time (monthly history + recent daily). Cached briefly.\n async getReviewHistogram(appid: number): Promise<Record<string, unknown>> {\n return this.#cache.wrapStaleOnError(`hist:${appid}:${this.#l}`, async () => {\n const res = await this.#http.getJson<ReviewHistogramResponse>(`appreviewhistogram/${appid}`, {\n query: { l: this.#l },\n });\n return summarizeReviewHistogram(res);\n });\n }\n\n // Featured/specials change often; cache briefly via the shared TTL.\n async getFeatured(country?: string, language?: string): Promise<Record<string, unknown>> {\n const cc = country ?? this.#cc;\n const l = language ?? this.#l;\n return this.#cache.wrapStaleOnError(`featured:${cc}:${l}`, async () => {\n const res = await this.#http.getJson<FeaturedResponse>(\"api/featuredcategories\", {\n query: { cc, l },\n });\n return summarizeFeatured(res);\n });\n }\n\n async getSpecials(country?: string, language?: string): Promise<Record<string, unknown>> {\n const cc = country ?? this.#cc;\n const l = language ?? this.#l;\n return this.#cache.wrapStaleOnError(`specials:${cc}:${l}`, async () => {\n const res = await this.#http.getJson<FeaturedResponse>(\"api/featuredcategories\", {\n query: { cc, l },\n });\n return summarizeSpecials(res);\n });\n }\n}\n","// Read-only client for the official Steam Web API (api.steampowered.com).\n// Valve states that all Web API use requires a free key\n// (https://steamcommunity.com/dev/apikey), so player tools require STEAM_API_KEY.\n// A couple of endpoints (news, global achievement %) currently also answer\n// without a key; we send the key when present and let them work either way.\n// Reference: https://developer.valvesoftware.com/wiki/Steam_Web_API\nimport { HttpClient } from \"../lib/http.js\";\nimport { RateLimiter } from \"../lib/rateLimit.js\";\nimport { TtlCache } from \"../lib/cache.js\";\nimport { ApiError } from \"../lib/errors.js\";\nimport {\n summarizeCurrentPlayers,\n summarizeGameSchema,\n summarizeGlobalAchievements,\n summarizeDiscover,\n summarizeItems,\n summarizeNews,\n summarizeOwnedGames,\n summarizePlayer,\n summarizePlayerAchievements,\n summarizeRecentlyPlayed,\n summarizeVanity,\n summarizeWishlist,\n type CurrentPlayersResponse,\n type GameSchemaResponse,\n type GlobalAchievementsResponse,\n type NewsResponse,\n type OwnedGamesResponse,\n type PlayerAchievementsResponse,\n type PlayerSummariesResponse,\n type StoreItemsResponse,\n type StoreQueryResponse,\n type VanityResponse,\n type WishlistResponse,\n} from \"../format.js\";\nimport type { Logger } from \"../lib/logger.js\";\nimport type { Config } from \"../config.js\";\n\ntype Query = Record<string, string | number | boolean | undefined>;\n\nconst PRIVATE_PROFILE_REASON =\n \"Profile or game-details are private. Ask the owner to set Steam → Privacy → \" +\n \"Game details = Public.\";\n\nexport class SteamWebClient {\n readonly #http: HttpClient;\n readonly #cache: TtlCache<Record<string, unknown>>;\n readonly #key: string | undefined;\n readonly #l: string;\n readonly #country: string;\n /** True when a Steam Web API key is configured; player tools short-circuit otherwise. */\n readonly configured: boolean;\n\n constructor(config: Config, logger: Logger) {\n this.#key = config.steamApiKey;\n this.#l = config.language;\n this.#country = config.country;\n this.configured = Boolean(config.steamApiKey);\n const limiter = new RateLimiter(config.apiMinIntervalMs);\n this.#http = new HttpClient({\n baseUrl: config.steamApiBaseUrl,\n logger,\n timeoutMs: config.httpTimeoutMs,\n retries: config.httpRetries,\n beforeRequest: () => limiter.acquire(),\n });\n this.#cache = new TtlCache(config.cacheTtlMs);\n }\n\n #get<T>(path: string, query: Query): Promise<T> {\n return this.#http.getJson<T>(path, { query: { key: this.#key, ...query } });\n }\n\n // ---- player data (key required) -------------------------------------------\n\n async getPlayerSummary(steamid: string): Promise<Record<string, unknown>> {\n const res = await this.#get<PlayerSummariesResponse>(\"ISteamUser/GetPlayerSummaries/v2/\", {\n steamids: steamid,\n });\n return summarizePlayer(res);\n }\n\n async getOwnedGames(steamid: string): Promise<Record<string, unknown>> {\n const res = await this.#get<OwnedGamesResponse>(\"IPlayerService/GetOwnedGames/v1/\", {\n steamid,\n include_appinfo: true,\n include_played_free_games: true,\n });\n return summarizeOwnedGames(res);\n }\n\n async getRecentlyPlayed(steamid: string): Promise<Record<string, unknown>> {\n const res = await this.#get<OwnedGamesResponse>(\"IPlayerService/GetRecentlyPlayedGames/v1/\", {\n steamid,\n });\n return summarizeRecentlyPlayed(res);\n }\n\n async getPlayerAchievements(steamid: string, appid: number): Promise<Record<string, unknown>> {\n try {\n const res = await this.#get<PlayerAchievementsResponse>(\n \"ISteamUserStats/GetPlayerAchievements/v1/\",\n { steamid, appid, l: this.#l },\n );\n if (res.playerstats?.success) return summarizePlayerAchievements(res);\n // 200 but success:false — disambiguate private vs no-achievements.\n return this.#explainNoPlayerAchievements(appid, res.playerstats?.error);\n } catch (e) {\n // Steam answers 403 for a private profile, 400 for an app with no stats /\n // not owned. Turn both into a clear, actionable reason.\n if (e instanceof ApiError && (e.code === \"forbidden\" || e.code === \"unauthorized\")) {\n return { found: false, reason: PRIVATE_PROFILE_REASON };\n }\n if (e instanceof ApiError && (e.code === \"bad_request\" || e.code === \"not_found\")) {\n return this.#explainNoPlayerAchievements(appid);\n }\n throw e;\n }\n }\n\n // On failure, check the game's schema: if it HAS achievements the player data\n // is hidden (private/not owned); if it has none, the game simply has no\n // achievements. Only runs on the failure path, so the happy path stays 1 call.\n async #explainNoPlayerAchievements(\n appid: number,\n apiError?: string,\n ): Promise<Record<string, unknown>> {\n if (apiError && /not public|private/i.test(apiError)) {\n return { found: false, reason: PRIVATE_PROFILE_REASON };\n }\n try {\n const schema = await this.#get<GameSchemaResponse>(\"ISteamUserStats/GetSchemaForGame/v2/\", {\n appid,\n l: this.#l,\n });\n const has = (schema.game?.availableGameStats?.achievements?.length ?? 0) > 0;\n return {\n found: false,\n reason: has\n ? \"This game has achievements, but the player's data is hidden (private game-details, or they don't own it).\"\n : \"This game has no achievements.\",\n };\n } catch {\n return { found: false, reason: apiError || \"Achievements unavailable.\" };\n }\n }\n\n async resolveVanityUrl(vanity: string): Promise<Record<string, unknown>> {\n const res = await this.#get<VanityResponse>(\"ISteamUser/ResolveVanityURL/v1/\", {\n vanityurl: vanity,\n });\n return summarizeVanity(res);\n }\n\n // ---- keyless-capable (key sent when present) ------------------------------\n\n async getNews(appid: number, count: number): Promise<Record<string, unknown>> {\n const res = await this.#get<NewsResponse>(\"ISteamNews/GetNewsForApp/v2/\", {\n appid,\n count,\n maxlength: 400,\n });\n return summarizeNews(res);\n }\n\n async getGlobalAchievements(appid: number): Promise<Record<string, unknown>> {\n return this.#cache.wrapStaleOnError(`global-ach:${appid}`, async () => {\n const res = await this.#get<GlobalAchievementsResponse>(\n \"ISteamUserStats/GetGlobalAchievementPercentagesForApp/v2/\",\n { gameid: appid },\n );\n return summarizeGlobalAchievements(res);\n });\n }\n\n // Current concurrent player count for a game. Not cached — it's a live number.\n async getCurrentPlayers(appid: number): Promise<Record<string, unknown>> {\n const res = await this.#get<CurrentPlayersResponse>(\n \"ISteamUserStats/GetNumberOfCurrentPlayers/v1/\",\n { appid },\n );\n return summarizeCurrentPlayers(res, appid);\n }\n\n // Batch store card (price+discount, review %, release) for a list of appids in\n // one keyless call via the modern store-browse service. The efficient way to\n // price- and rating-check a known list (wishlist/library) without N requests.\n async getItems(\n appids: number[],\n country?: string,\n language?: string,\n ): Promise<Record<string, unknown>> {\n const input = {\n ids: appids.map((appid) => ({ appid })),\n context: { language: language ?? this.#l, country_code: country ?? this.#country },\n data_request: { include_basic_info: true, include_reviews: true, include_release: true },\n };\n const res = await this.#get<StoreItemsResponse>(\"IStoreBrowseService/GetItems/v1/\", {\n input_json: JSON.stringify(input),\n });\n return summarizeItems(res, appids);\n }\n\n // Catalog-wide deal discovery (keyless) via the store query backend: find all\n // games at/above a minimum discount, with price + review % in the same call.\n // `minReview`/`minReviews` filter the returned page (the Query API ignores\n // review filters), so widen `count` for stricter thresholds.\n async discoverDeals(p: {\n minDiscount: number;\n count?: number;\n start?: number;\n minReview?: number;\n minReviews?: number;\n country?: string;\n language?: string;\n }): Promise<Record<string, unknown>> {\n const input = {\n query: {\n start: p.start ?? 0,\n count: p.count ?? 50,\n filters: { price_filters: { min_discount_percent: p.minDiscount } },\n },\n context: {\n language: p.language ?? this.#l,\n country_code: p.country ?? this.#country,\n steam_realm: 1,\n },\n data_request: { include_basic_info: true, include_reviews: true },\n };\n const res = await this.#get<StoreQueryResponse>(\"IStoreQueryService/Query/v1/\", {\n input_json: JSON.stringify(input),\n });\n return summarizeDiscover(res, { minReview: p.minReview, minReviews: p.minReviews });\n }\n\n // A player's wishlist (needs the wishlist/profile to be public). Keyless.\n async getWishlist(steamid: string): Promise<Record<string, unknown>> {\n const res = await this.#get<WishlistResponse>(\"IWishlistService/GetWishlist/v1/\", { steamid });\n return summarizeWishlist(res);\n }\n\n // Full achievement list for a game (GetSchemaForGame needs a key), merged with\n // the keyless global unlock % so each achievement carries its rarity. Cached.\n async getGameAchievements(appid: number, language?: string): Promise<Record<string, unknown>> {\n const l = language ?? this.#l;\n return this.#cache.wrapStaleOnError(`schema:${appid}:${l}`, async () => {\n const [schema, global] = await Promise.all([\n this.#get<GameSchemaResponse>(\"ISteamUserStats/GetSchemaForGame/v2/\", {\n appid,\n l,\n }),\n this.#get<GlobalAchievementsResponse>(\n \"ISteamUserStats/GetGlobalAchievementPercentagesForApp/v2/\",\n { gameid: appid },\n ),\n ]);\n return summarizeGameSchema(schema, global);\n });\n }\n}\n","// Steam Storefront tools — game/store data that needs no API key. Descriptions\n// and per-field .describe() text are written for the calling model: when to use\n// a tool and the meaning of every parameter. Handlers wrap calls in guard() so\n// failures become actionable tool errors.\nimport { z } from \"zod\";\nimport type { McpServer } from \"@modelcontextprotocol/sdk/server/mcp.js\";\nimport type { StorefrontClient } from \"../clients/storefront.js\";\nimport { jsonResult, type ToolResult } from \"../lib/result.js\";\nimport { guard } from \"./guard.js\";\n\nconst READ_ONLY = { readOnlyHint: true, openWorldHint: true } as const;\nconst appid = z\n .number()\n .int()\n .positive()\n .describe(\"Steam application id (appid). Get it from search_games.\");\n// Per-call overrides of the server defaults (STEAM_COUNTRY / STEAM_LANGUAGE).\nconst country = z\n .string()\n .regex(/^[A-Za-z]{2}$/, \"Two-letter ISO country code, e.g. US, RU, DE.\")\n .describe(\"Country (cc) for prices/currency; overrides STEAM_COUNTRY for this call.\")\n .optional();\nconst language = z\n .string()\n .min(2)\n .describe(\"Store language (e.g. english, russian); overrides STEAM_LANGUAGE for this call.\")\n .optional();\n\nconst reply = (fn: () => Promise<Record<string, unknown>>): Promise<ToolResult> =>\n guard(async () => jsonResult(await fn()));\n\nexport function registerStorefrontTools(server: McpServer, store: StorefrontClient): void {\n server.registerTool(\n \"search_games\",\n {\n title: \"Search games\",\n description:\n \"Search the Steam store by title; returns matches with their appid (needed by the other \" +\n \"game tools), price, Metacritic score and platforms. No API key required.\",\n inputSchema: {\n term: z.string().min(1).describe(\"Game title to search for.\"),\n country,\n language,\n },\n annotations: READ_ONLY,\n },\n ({ term, country: cc, language: l }) => reply(() => store.searchGames(term, cc, l)),\n );\n\n server.registerTool(\n \"get_game\",\n {\n title: \"Get game details\",\n description:\n \"Get full store details for one game by appid: description, price/discount, genres, \" +\n \"platforms, release date, developers/publishers, Metacritic, age rating, DLC and PC \" +\n \"requirements. Get the appid from search_games. No API key required.\",\n inputSchema: { appid, country, language },\n annotations: READ_ONLY,\n },\n ({ appid: id, country: cc, language: l }) => reply(() => store.getGame(id, cc, l)),\n );\n\n server.registerTool(\n \"get_game_reviews\",\n {\n title: \"Get game reviews\",\n description:\n \"Get the review summary (score label, positive/negative counts, %) and a few recent \" +\n \"reviews for a game by appid. Get the appid from search_games. No API key required.\",\n inputSchema: {\n appid,\n limit: z\n .number()\n .int()\n .min(1)\n .max(20)\n .describe(\"How many recent reviews (1-20).\")\n .optional(),\n review_language: z\n .string()\n .describe(\"Filter reviews by language, e.g. 'english'. Default 'all'.\")\n .optional(),\n type: z\n .enum([\"all\", \"positive\", \"negative\"])\n .describe(\"Only positive or negative reviews. Default 'all'.\")\n .optional(),\n },\n annotations: READ_ONLY,\n },\n ({ appid: id, limit, review_language, type }) =>\n reply(() => store.getReviews(id, limit ?? 5, review_language ?? \"all\", type ?? \"all\")),\n );\n\n server.registerTool(\n \"get_review_histogram\",\n {\n title: \"Get review trend over time\",\n description:\n \"Get how a game's reviews trend over time by appid: a long-term (monthly) history and the \" +\n \"recent per-day breakdown, each with positive/negative counts and positive %. Good for \" +\n \"'are reviews improving / did an update hurt reception'. Get the appid from search_games. No key.\",\n inputSchema: { appid },\n annotations: READ_ONLY,\n },\n ({ appid: id }) => reply(() => store.getReviewHistogram(id)),\n );\n\n server.registerTool(\n \"get_prices\",\n {\n title: \"Get prices for many games\",\n description:\n \"Get current price and discount for a batch of games by appid in one call — efficient for \" +\n \"checking a whole list (e.g. a wishlist) for deals. Each row has the final/initial price and \" +\n \"discount_percent (or is_free). No API key required. Get appids from search_games or get_wishlist.\",\n inputSchema: {\n appids: z\n .array(z.number().int().positive())\n .min(1)\n .max(500)\n .describe(\"Steam appids to price (1-500).\"),\n country,\n },\n annotations: READ_ONLY,\n },\n ({ appids, country: cc }) => reply(() => store.getPrices(appids, cc)),\n );\n\n server.registerTool(\n \"get_specials\",\n {\n title: \"Get current discounts\",\n description:\n \"List games currently on special (discounted) on the Steam store front page, with the \" +\n \"discount % and original/final price. For ALL catalog discounts (not just the front page), \" +\n \"use discover_deals. No API key required.\",\n inputSchema: { country, language },\n annotations: READ_ONLY,\n },\n ({ country: cc, language: l }) => reply(() => store.getSpecials(cc, l)),\n );\n\n server.registerTool(\n \"get_featured\",\n {\n title: \"Get featured store sections\",\n description:\n \"Get the Steam store's featured sections: specials, top sellers, new releases and coming \" +\n \"soon (each a list of games with appid and price). No API key required.\",\n inputSchema: { country, language },\n annotations: READ_ONLY,\n },\n ({ country: cc, language: l }) => reply(() => store.getFeatured(cc, l)),\n );\n}\n","// Helpers that build MCP tool results. Tool handlers return these objects;\n// failures become { isError: true } results (never thrown) so the agent\n// receives an actionable message instead of a protocol error.\nimport type { ApiError } from \"./errors.js\";\n\nexport interface ToolResult {\n content: { type: \"text\"; text: string }[];\n structuredContent?: Record<string, unknown>;\n isError?: boolean;\n // Matches the SDK's CallToolResult index signature.\n [key: string]: unknown;\n}\n\n/** Success result carrying both a text mirror and structured data.\n *\n * The text is compact (no indentation): MCP clients that don't read\n * `structuredContent` fall back to this string and feed it to the model, so\n * pretty-print whitespace would be pure token overhead. */\nexport function jsonResult(structured: Record<string, unknown>): ToolResult {\n return {\n content: [{ type: \"text\", text: JSON.stringify(structured) }],\n structuredContent: structured,\n };\n}\n\nexport function errorResult(message: string): ToolResult {\n return { content: [{ type: \"text\", text: message }], isError: true };\n}\n\n/** Translate an upstream ApiError into a friendly, actionable tool error. */\nexport function apiErrorToResult(err: ApiError): ToolResult {\n return errorResult(messageFor(err));\n}\n\nfunction messageFor(err: ApiError): string {\n switch (err.code) {\n case \"unauthorized\":\n return (\n \"The upstream service rejected the credentials (401). They may be missing or expired — \" +\n \"check the configured API key / token.\"\n );\n case \"forbidden\":\n return \"The upstream service denied access (403). The credentials may lack permission.\";\n case \"not_found\":\n return \"No matching resource was found (404).\";\n case \"not_modified\":\n return \"The content has not changed since the last request (304).\";\n case \"rate_limited\":\n return \"Upstream rate limit hit (429). Please retry in a few seconds.\";\n case \"server_error\":\n return \"The upstream service returned an error (5xx). Please retry later.\";\n case \"network\":\n return \"Could not reach the upstream service (network error). Check connectivity and retry.\";\n case \"timeout\":\n return \"The upstream request timed out. Please retry.\";\n case \"bad_request\":\n return `The request was rejected as invalid: ${err.message}`;\n default:\n return `Unexpected error talking to the upstream service: ${err.message}`;\n }\n}\n","// Shared helper: run a tool body and convert any failure into a tool result\n// (never throw), so the agent receives an actionable message.\nimport { ApiError } from \"../lib/errors.js\";\nimport { apiErrorToResult, errorResult, type ToolResult } from \"../lib/result.js\";\n\nexport async function guard(fn: () => Promise<ToolResult>): Promise<ToolResult> {\n try {\n return await fn();\n } catch (err) {\n if (err instanceof ApiError) return apiErrorToResult(err);\n return errorResult(`Unexpected error: ${err instanceof Error ? err.message : String(err)}`);\n }\n}\n","// Steam Web API tools. Player tools (profile, library, achievements, vanity)\n// require a free key (STEAM_API_KEY); they short-circuit with a clear message\n// when it's missing. News and global achievement % are exposed without that\n// gate since Steam currently serves them keyless (a key is still sent if set).\nimport { z } from \"zod\";\nimport type { McpServer } from \"@modelcontextprotocol/sdk/server/mcp.js\";\nimport type { SteamWebClient } from \"../clients/web.js\";\nimport { jsonResult, errorResult, type ToolResult } from \"../lib/result.js\";\nimport { guard } from \"./guard.js\";\n\nconst READ_ONLY = { readOnlyHint: true, openWorldHint: true } as const;\nconst appid = z\n .number()\n .int()\n .positive()\n .describe(\"Steam application id (appid). Get it from search_games.\");\nconst steamid = z\n .string()\n .regex(\n /^\\d{17}$/,\n \"A SteamID64 is 17 digits. Use resolve_vanity_url to convert a custom profile name.\",\n )\n .describe(\"17-digit SteamID64. Convert a vanity/custom URL name with resolve_vanity_url first.\");\n\nconst reply = (fn: () => Promise<Record<string, unknown>>): Promise<ToolResult> =>\n guard(async () => jsonResult(await fn()));\n\nexport function registerWebTools(server: McpServer, web: SteamWebClient): void {\n // Gate player tools on the key; one clear message instead of a round-trip 403.\n const requireKey = (fn: () => Promise<Record<string, unknown>>): Promise<ToolResult> => {\n if (!web.configured) {\n return Promise.resolve(\n errorResult(\n \"This tool needs a Steam Web API key. Set STEAM_API_KEY to a free key from \" +\n \"https://steamcommunity.com/dev/apikey. (Note: the target profile must also be public.)\",\n ),\n );\n }\n return reply(fn);\n };\n\n // ---- keyless-capable ------------------------------------------------------\n\n server.registerTool(\n \"get_game_news\",\n {\n title: \"Get game news\",\n description:\n \"Get recent news / patch notes for a game by appid (title, date, author, excerpt, link). \" +\n \"Get the appid from search_games. Works without an API key.\",\n inputSchema: {\n appid,\n limit: z.number().int().min(1).max(20).describe(\"How many news items (1-20).\").optional(),\n },\n annotations: READ_ONLY,\n },\n ({ appid: id, limit }) => reply(() => web.getNews(id, limit ?? 5)),\n );\n\n server.registerTool(\n \"get_global_achievements\",\n {\n title: \"Get global achievement rates\",\n description:\n \"Get the global unlock percentage of each achievement in a game by appid — how rare each \" +\n \"achievement is across all players. Get the appid from search_games. Works without a key.\",\n inputSchema: { appid },\n annotations: READ_ONLY,\n },\n ({ appid: id }) => reply(() => web.getGlobalAchievements(id)),\n );\n\n server.registerTool(\n \"get_items\",\n {\n title: \"Batch store card for many games\",\n description:\n \"Get price/discount, review % (positive) and release date for a LIST of games by appid in \" +\n \"ONE keyless call. The efficient way to price- and rating-check a wishlist or library \" +\n \"without a request per game. Get appids from search_games / get_wishlist / get_owned_games.\",\n inputSchema: {\n appids: z\n .array(z.number().int().positive())\n .min(1)\n .max(100)\n .describe(\"Steam appids (1-100).\"),\n country: z\n .string()\n .regex(/^[A-Za-z]{2}$/, \"Two-letter ISO country code.\")\n .describe(\"Country (cc) for prices; overrides STEAM_COUNTRY.\")\n .optional(),\n language: z\n .string()\n .min(2)\n .describe(\"Store language; overrides STEAM_LANGUAGE.\")\n .optional(),\n },\n annotations: READ_ONLY,\n },\n ({ appids, country, language }) => reply(() => web.getItems(appids, country, language)),\n );\n\n server.registerTool(\n \"discover_deals\",\n {\n title: \"Discover discounted games (catalog-wide)\",\n description:\n \"Find games currently on sale across the whole Steam catalog (keyless) — filter by minimum \" +\n \"discount, and optionally by review quality. Each result has discount %, price, review % and \" +\n \"release date in one call. Use for 'all games >80% off with good reviews'. No appids needed \" +\n \"(unlike get_items, which prices a list you already have).\",\n inputSchema: {\n min_discount: z\n .number()\n .int()\n .min(1)\n .max(100)\n .describe(\"Minimum discount %, e.g. 80 for '80%+ off'.\"),\n min_review: z\n .number()\n .int()\n .min(0)\n .max(100)\n .describe(\"Minimum positive-review %, e.g. 90. Applied over the returned page.\")\n .optional(),\n min_reviews: z\n .number()\n .int()\n .min(0)\n .describe(\"Minimum review count (filters shovelware with few reviews).\")\n .optional(),\n count: z\n .number()\n .int()\n .min(1)\n .max(200)\n .describe(\"How many catalog entries to scan (default 50). Raise for stricter filters.\")\n .optional(),\n start: z.number().int().min(0).describe(\"Pagination offset into the catalog.\").optional(),\n country: z\n .string()\n .regex(/^[A-Za-z]{2}$/, \"Two-letter ISO country code.\")\n .describe(\"Country (cc) for prices; overrides STEAM_COUNTRY.\")\n .optional(),\n language: z\n .string()\n .min(2)\n .describe(\"Store language; overrides STEAM_LANGUAGE.\")\n .optional(),\n },\n annotations: READ_ONLY,\n },\n ({ min_discount, min_review, min_reviews, count, start, country, language }) =>\n reply(() =>\n web.discoverDeals({\n minDiscount: min_discount,\n minReview: min_review,\n minReviews: min_reviews,\n count,\n start,\n country,\n language,\n }),\n ),\n );\n\n server.registerTool(\n \"get_current_players\",\n {\n title: \"Get current player count\",\n description:\n \"Get how many people are playing a game right now (live concurrent player count) by appid. \" +\n \"Get the appid from search_games. Works without a key.\",\n inputSchema: { appid },\n annotations: READ_ONLY,\n },\n ({ appid: id }) => reply(() => web.getCurrentPlayers(id)),\n );\n\n server.registerTool(\n \"get_wishlist\",\n {\n title: \"Get a player's wishlist\",\n description:\n \"List the appids on a player's Steam wishlist (sorted by their priority) by SteamID64. \" +\n \"Works without a key, but only if that player's wishlist/profile is public — otherwise it \" +\n \"returns found:false. Items carry no names; use get_game per appid for details. \" +\n \"Convert a vanity name with resolve_vanity_url first.\",\n inputSchema: { steamid },\n annotations: READ_ONLY,\n },\n ({ steamid: id }) => reply(() => web.getWishlist(id)),\n );\n\n // ---- player data (key required) -------------------------------------------\n\n server.registerTool(\n \"get_game_achievements\",\n {\n title: \"Get a game's full achievement list\",\n description:\n \"List ALL achievements of a game by appid with their names, descriptions, hidden flag and \" +\n \"global unlock % (rarity). Requires STEAM_API_KEY (the achievement schema needs a key). \" +\n \"For just the rarity by internal id without a key, use get_global_achievements; for a few \" +\n \"named highlights, see get_game's achievements_highlighted. Get the appid from search_games.\",\n inputSchema: {\n appid,\n language: z\n .string()\n .min(2)\n .describe(\"Language for achievement names/descriptions; overrides STEAM_LANGUAGE.\")\n .optional(),\n },\n annotations: READ_ONLY,\n },\n ({ appid: id, language }) => requireKey(() => web.getGameAchievements(id, language)),\n );\n\n server.registerTool(\n \"resolve_vanity_url\",\n {\n title: \"Resolve vanity URL to SteamID\",\n description:\n \"Convert a Steam custom (vanity) profile name — the part after /id/ in a profile URL — into \" +\n \"the 17-digit SteamID64 that the player tools need. Requires STEAM_API_KEY.\",\n inputSchema: {\n vanity: z\n .string()\n .min(1)\n .describe(\n \"Vanity name, e.g. 'gabelogannewell' from steamcommunity.com/id/gabelogannewell.\",\n ),\n },\n annotations: READ_ONLY,\n },\n ({ vanity }) => requireKey(() => web.resolveVanityUrl(vanity)),\n );\n\n server.registerTool(\n \"get_player_summary\",\n {\n title: \"Get player profile\",\n description:\n \"Get a player's public profile by SteamID64: display name, online state, country, account \" +\n \"age, and the game they're currently in. Requires STEAM_API_KEY and a public profile.\",\n inputSchema: { steamid },\n annotations: READ_ONLY,\n },\n ({ steamid: id }) => requireKey(() => web.getPlayerSummary(id)),\n );\n\n server.registerTool(\n \"get_owned_games\",\n {\n title: \"Get owned games\",\n description:\n \"List the games a player owns with playtime (hours), most-played first. Requires \" +\n \"STEAM_API_KEY and a public profile + game-details visibility. Get the SteamID64 from resolve_vanity_url.\",\n inputSchema: { steamid },\n annotations: READ_ONLY,\n },\n ({ steamid: id }) => requireKey(() => web.getOwnedGames(id)),\n );\n\n server.registerTool(\n \"get_recently_played\",\n {\n title: \"Get recently played games\",\n description:\n \"List the games a player has played in the last two weeks, with recent and total playtime. \" +\n \"Requires STEAM_API_KEY and a public profile.\",\n inputSchema: { steamid },\n annotations: READ_ONLY,\n },\n ({ steamid: id }) => requireKey(() => web.getRecentlyPlayed(id)),\n );\n\n server.registerTool(\n \"get_player_achievements\",\n {\n title: \"Get a player's achievements\",\n description:\n \"Get a player's achievement progress for one game (unlocked count, % complete, per-achievement \" +\n \"unlock dates) by SteamID64 + appid. Requires STEAM_API_KEY and a public profile.\",\n inputSchema: { steamid, appid },\n annotations: READ_ONLY,\n },\n ({ steamid: id, appid: app }) => requireKey(() => web.getPlayerAchievements(id, app)),\n );\n}\n","// Bin entry point. tsup prepends the `#!/usr/bin/env node` shebang.\nimport { start } from \"./server.js\";\n\nstart().catch((err: unknown) => {\n // Fatal startup error: report on stderr and exit non-zero.\n process.stderr.write(\n `[mcp-server-template] fatal: ${err instanceof Error ? err.message : String(err)}\\n`,\n );\n process.exit(1);\n});\n"],"mappings":"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","names":["delay","appid","country","language","appid","steamid","appid","country","language","z","z","z","READ_ONLY","appid","z","reply","country","language","start"]}
package/package.json ADDED
@@ -0,0 +1,69 @@
1
+ {
2
+ "name": "steam-games-mcp",
3
+ "version": "0.2.0",
4
+ "description": "MCP server for Steam: game/store data (no key) plus player profiles, libraries and achievements via the Steam Web API.",
5
+ "type": "module",
6
+ "license": "MIT",
7
+ "author": {
8
+ "name": "Grinv",
9
+ "email": "4070730+Grinv@users.noreply.github.com",
10
+ "url": "https://github.com/Grinv"
11
+ },
12
+ "keywords": [
13
+ "mcp",
14
+ "model-context-protocol",
15
+ "steam",
16
+ "steamworks",
17
+ "games"
18
+ ],
19
+ "repository": {
20
+ "type": "git",
21
+ "url": "git+https://github.com/Grinv/steam-games-mcp.git"
22
+ },
23
+ "engines": {
24
+ "node": ">=18"
25
+ },
26
+ "bin": {
27
+ "steam-games-mcp": "dist/index.js"
28
+ },
29
+ "main": "dist/index.js",
30
+ "files": [
31
+ "dist",
32
+ "README.md",
33
+ "LICENSE",
34
+ "CHANGELOG.md"
35
+ ],
36
+ "scripts": {
37
+ "typecheck": "tsc --noEmit",
38
+ "build": "npm run typecheck && tsup",
39
+ "build:tests": "node scripts/build-tests.mjs",
40
+ "test": "npm run build:tests && node scripts/run-tests.mjs",
41
+ "test:coverage": "npm run build:tests && node scripts/run-tests.mjs --coverage",
42
+ "lint": "eslint .",
43
+ "check:api": "node scripts/check-api.mjs",
44
+ "format": "prettier --write .",
45
+ "format:check": "prettier --check .",
46
+ "start": "node dist/index.js",
47
+ "inspector": "npm run build && npx @modelcontextprotocol/inspector node dist/index.js"
48
+ },
49
+ "dependencies": {
50
+ "@modelcontextprotocol/sdk": "1.29.0",
51
+ "zod": "4.4.3"
52
+ },
53
+ "devDependencies": {
54
+ "@anthropic-ai/mcpb": "2.1.2",
55
+ "@eslint/js": "10.0.1",
56
+ "@types/node": "26.0.1",
57
+ "esbuild": "0.28.1",
58
+ "eslint": "10.6.0",
59
+ "eslint-config-prettier": "10.1.8",
60
+ "prettier": "3.9.0",
61
+ "tsup": "8.5.1",
62
+ "typescript": "6.0.3",
63
+ "typescript-eslint": "8.62.0"
64
+ },
65
+ "allowScripts": {
66
+ "esbuild@0.28.1": true,
67
+ "esbuild@0.27.7": true
68
+ }
69
+ }