mcgl-mcp 0.0.0-stage → 0.1.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 exi66
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,83 @@
-# Temporary Holding Version
+# mcgl-mcp
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+[![npm](https://img.shields.io/npm/v/mcgl-mcp)](https://www.npmjs.com/package/mcgl-mcp)
+[![CI](https://github.com/exi66/mcgl-mcp/actions/workflows/ci.yml/badge.svg)](https://github.com/exi66/mcgl-mcp/actions/workflows/ci.yml)
+
+MCP-сервер для [форума Minecraft Galaxy](https://forum.minecraft-galaxy.ru/main/). Подключается к Claude, Cursor и другим AI-ассистентам и даёт им читать форум: разделы, темы, посты, опросы.
+
+Что можно попросить у ассистента:
+
+- «Что нового на форуме MCGL?»
+- «Перескажи последние сообщения в теме про Гран-при амфибий»
+- «О чём спорят в разделе Предложения?»
+- «Найди в теме 133931 рецепт крафта и объясни его»
+
+## Установка
+
+Нужен [Node.js](https://nodejs.org) 22 или новее. Отдельно ставить ничего не надо: клиент сам скачает и запустит сервер через `npx`.
+
+**Claude Code:**
+
+```bash
+claude mcp add mcgl -- npx -y mcgl-mcp
+```
+
+**Claude Desktop, Cursor и другие:** добавьте в конфиг MCP-серверов (`claude_desktop_config.json`, `.cursor/mcp.json` и т.п.):
+
+```json
+{
+  "mcpServers": {
+    "mcgl": {
+      "command": "npx",
+      "args": ["-y", "mcgl-mcp"]
+    }
+  }
+}
+```
+
+На Windows, если клиент не находит `npx`: `"command": "cmd"`, `"args": ["/c", "npx", "-y", "mcgl-mcp"]`.
+
+### Вход под своим аккаунтом (необязательно)
+
+Сейчас все инструменты работают и без входа. Вход понадобится для действий от вашего имени, например чтобы писать посты: это в планах. Настроить его можно уже сейчас.
+
+```bash
+claude mcp add mcgl -e FORUM_LOGIN=ник -e FORUM_PASSWORD=пароль -- npx -y mcgl-mcp
+```
+
+В JSON-конфиге то же самое задаётся через `"env": { "FORUM_LOGIN": "ник", "FORUM_PASSWORD": "пароль" }`.
+
+Пароль хранится только в конфиге клиента на вашем компьютере и отправляется только на форум. Если войти не получилось, текст ошибки форума виден в логах MCP-сервера в клиенте. У форума есть лимит попыток входа, поэтому после неудачи сервер больше не пытается войти: исправьте пароль и перезапустите клиент.
+
+## Инструменты
+
+| Инструмент            | Что делает                                                                           |
+| --------------------- | ------------------------------------------------------------------------------------ |
+| `forum_list_sections` | разделы форума по категориям                                                         |
+| `forum_latest_topics` | темы со свежими сообщениями во всех разделах                                         |
+| `forum_list_topics`   | темы раздела: закреплённые, закрытые, кто может отвечать                             |
+| `forum_get_topic`     | посты темы по 15 штук; по умолчанию — последние, плюс опрос и кто читает тему сейчас |
+| `forum_get_post`      | один пост по ссылке `/post/N` и где он находится в теме                              |
+
+## Настройки
+
+Переменные окружения задаются в конфиге клиента, все необязательные.
+
+| Переменная                      | По умолчанию                        | Что это                                    |
+| ------------------------------- | ----------------------------------- | ------------------------------------------ |
+| `FORUM_LOGIN`, `FORUM_PASSWORD` | —                                   | вход под своим аккаунтом                   |
+| `LOG_LEVEL`                     | `info`                              | `debug` — подробные логи для отладки       |
+| `FORUM_MIN_INTERVAL_MS`         | `300`                               | минимальная пауза между запросами к форуму |
+| `FORUM_TIMEOUT_MS`              | `15000`                             | таймаут одного запроса к форуму            |
+| `FORUM_BASE_URL`                | `https://forum.minecraft-galaxy.ru` | адрес форума                               |
+
+## Документация
+
+- [Как сервер работает с форумом](docs/forum.md): вход, пагинация тем, bbCode, предметы, недоступность форума.
+- [Разработка](docs/development.md): запуск из исходников, тесты, релизы, свой HTTP-сервер.
+
+Нашли ошибку или форум что-то поменял — [заведите issue](https://github.com/exi66/mcgl-mcp/issues/new/choose).
+
+## Лицензия
+
+[MIT](LICENSE)

package/dist/entry/http.js

@@ -0,0 +1,49 @@
+import { createMcpExpressApp } from "@modelcontextprotocol/sdk/server/express.js";
+import { StreamableHTTPServerTransport } from "@modelcontextprotocol/sdk/server/streamableHttp.js";
+import { loadForumEnv, loadHttpEnv } from "../env.js";
+import { ForumHttp } from "../forum/http.js";
+import { ForumReader } from "../forum/reader.js";
+import { RateLimiter } from "../forum/rate-limiter.js";
+import { createLogger } from "../logger.js";
+import { createMcpServer, SERVER_INFO } from "../mcp/server.js";
+const logger = createLogger("http");
+const forumEnv = loadForumEnv();
+const httpEnv = loadHttpEnv();
+// Общий анонимный клиент и общий лимитер: все запросы к форуму идут с IP хоста.
+const limiter = new RateLimiter(forumEnv.minIntervalMs);
+const forumHttp = new ForumHttp(forumEnv, limiter);
+const reader = new ForumReader(forumHttp);
+const app = createMcpExpressApp({ host: httpEnv.host, allowedHosts: httpEnv.allowedHosts });
+// Сам сервер жив (ok), форум — по данным circuit breaker (без лишних запросов к нему).
+app.get("/health", (_req, res) => {
+    res.json({ ok: true, ...SERVER_INFO, forum: forumHttp.health.status });
+});
+const MCP_PATH = "/public/mcp";
+app.post(MCP_PATH, async (req, res) => {
+    const server = createMcpServer({ reader });
+    const transport = new StreamableHTTPServerTransport({ sessionIdGenerator: undefined });
+    res.on("close", () => {
+        void transport.close();
+        void server.close();
+    });
+    try {
+        await server.connect(transport);
+        await transport.handleRequest(req, res, req.body);
+    }
+    catch (error) {
+        logger.error("Error handling MCP request", error);
+        if (!res.headersSent) {
+            res.status(500).json({ jsonrpc: "2.0", error: { code: -32603, message: "Internal server error" }, id: null });
+        }
+    }
+});
+// Stateless-режим: ни GET (SSE-стрим), ни DELETE (закрытие сессии) не нужны.
+const methodNotAllowed = (_req, res) => {
+    res.status(405).json({ jsonrpc: "2.0", error: { code: -32000, message: "Method not allowed." }, id: null });
+};
+app.get(MCP_PATH, methodNotAllowed);
+app.delete(MCP_PATH, methodNotAllowed);
+app.listen(httpEnv.port, httpEnv.host, () => {
+    logger.info(`Listening on http://${httpEnv.host}:${httpEnv.port}${MCP_PATH} (forum: ${forumEnv.baseUrl})`);
+});
+//# sourceMappingURL=http.js.map

package/dist/entry/stdio.js

@@ -0,0 +1,36 @@
+#!/usr/bin/env node
+/**
+ * Локальный режим: MCP-клиент запускает процесс и общается через stdin/stdout.
+ * Креды игрока берутся из env (FORUM_LOGIN / FORUM_PASSWORD), которые пользователь
+ * сам прописывает в конфиге клиента. Без них доступны только публичные инструменты.
+ */
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { loadForumEnv, loadPlayerCredentials } from "../env.js";
+import { ForumHttp } from "../forum/http.js";
+import { PlayerSession } from "../forum/player-session.js";
+import { ForumReader } from "../forum/reader.js";
+import { RateLimiter } from "../forum/rate-limiter.js";
+import { createLogger } from "../logger.js";
+import { createMcpServer } from "../mcp/server.js";
+const logger = createLogger("stdio");
+async function main() {
+    const forumEnv = loadForumEnv();
+    const credentials = loadPlayerCredentials();
+    const http = new ForumHttp(forumEnv, new RateLimiter(forumEnv.minIntervalMs));
+    if (!credentials) {
+        await createMcpServer({ reader: new ForumReader(http) }).connect(new StdioServerTransport());
+        logger.info("Started with public tools only (FORUM_LOGIN/FORUM_PASSWORD not set)");
+        return;
+    }
+    const session = new PlayerSession(http, credentials);
+    await createMcpServer({ reader: new ForumReader(http, session), session }).connect(new StdioServerTransport());
+    logger.info(`Started with player tools for login "${credentials.login}"`);
+    // Логинимся сразу, чтобы неверный пароль был виден в логах клиента при старте,
+    // а не при первом вызове инструмента. Процесс не падает: ошибку получит и инструмент.
+    session.whoami().then((username) => logger.info(`Authorized as ${username}`), (error) => logger.error(`Authorization failed: ${error instanceof Error ? error.message : String(error)}`));
+}
+main().catch((error) => {
+    logger.error("Fatal", error);
+    process.exit(1);
+});
+//# sourceMappingURL=stdio.js.map

package/dist/env.js

@@ -0,0 +1,57 @@
+import { DEFAULT_FORUM_URL } from "./forum/site.js";
+function str(name, fallback) {
+    const value = process.env[name]?.trim() || fallback;
+    if (value === undefined) {
+        throw new Error(`Missing required environment variable: ${name}`);
+    }
+    return value;
+}
+function optional(name) {
+    const value = process.env[name]?.trim();
+    return value ? value : undefined;
+}
+function int(name, fallback) {
+    const raw = optional(name);
+    if (raw === undefined)
+        return fallback;
+    const value = Number(raw);
+    if (!Number.isInteger(value) || value < 0) {
+        throw new Error(`Environment variable ${name} must be a non-negative integer, got "${raw}"`);
+    }
+    return value;
+}
+/** Настройки доступа к форуму, общие для обоих режимов. */
+export function loadForumEnv() {
+    return {
+        baseUrl: str("FORUM_BASE_URL", DEFAULT_FORUM_URL).replace(/\/+$/, ""),
+        minIntervalMs: int("FORUM_MIN_INTERVAL_MS", 300),
+        timeoutMs: int("FORUM_TIMEOUT_MS", 15000),
+    };
+}
+/**
+ * Креды игрока для локального режима. Пользователь сам кладёт их в env
+ * в конфиге своего MCP-клиента. Если они не заданы, сервер стартует только
+ * с публичными инструментами.
+ */
+export function loadPlayerCredentials() {
+    const login = optional("FORUM_LOGIN");
+    const password = optional("FORUM_PASSWORD");
+    if (!login && !password)
+        return undefined;
+    if (!login || !password) {
+        throw new Error("FORUM_LOGIN and FORUM_PASSWORD must be set together");
+    }
+    return { login, password };
+}
+export function loadHttpEnv() {
+    const allowedHosts = optional("ALLOWED_HOSTS")
+        ?.split(",")
+        .map((h) => h.trim())
+        .filter(Boolean);
+    return {
+        host: str("HOST", "0.0.0.0"),
+        port: int("PORT", 3000),
+        allowedHosts: allowedHosts?.length ? allowedHosts : undefined,
+    };
+}
+//# sourceMappingURL=env.js.map

package/dist/forum/cookie-jar.js

@@ -0,0 +1,45 @@
+/**
+ * Простейшее хранилище кук на один хост форума. Path, domain и secure
+ * не учитываются: мы всегда ходим на один и тот же origin.
+ */
+export class CookieJar {
+    cookies = new Map();
+    /** Применяет заголовки Set-Cookie из ответа. */
+    absorb(headers) {
+        for (const raw of headers.getSetCookie()) {
+            const [pair, ...attrs] = raw.split(";");
+            const eq = pair.indexOf("=");
+            if (eq <= 0)
+                continue;
+            const name = pair.slice(0, eq).trim();
+            const value = pair.slice(eq + 1).trim();
+            const expired = attrs.some((a) => {
+                const [k, v = ""] = a.split("=").map((s) => s.trim());
+                const key = k.toLowerCase();
+                if (key === "max-age")
+                    return Number(v) <= 0;
+                if (key === "expires")
+                    return Date.parse(v) <= Date.now();
+                return false;
+            });
+            if (expired || value === "" || value === "deleted") {
+                this.cookies.delete(name);
+            }
+            else {
+                this.cookies.set(name, value);
+            }
+        }
+    }
+    header() {
+        if (this.cookies.size === 0)
+            return undefined;
+        return [...this.cookies].map(([k, v]) => `${k}=${v}`).join("; ");
+    }
+    has(name) {
+        return this.cookies.has(name);
+    }
+    clear() {
+        this.cookies.clear();
+    }
+}
+//# sourceMappingURL=cookie-jar.js.map

package/dist/forum/errors.js

@@ -0,0 +1,38 @@
+/** Ошибка, текст которой можно показать агенту как результат инструмента. */
+export class ForumError extends Error {
+    constructor(message, options) {
+        super(message, options);
+        this.name = "ForumError";
+    }
+}
+/** Форум ответил страницей «войдите». Сессия будет переустановлена один раз. */
+export class SessionExpiredError extends ForumError {
+    constructor() {
+        super("Forum session expired");
+        this.name = "SessionExpiredError";
+    }
+}
+/** Логин не удался: неверные креды, бан, капча и т.п. */
+export class LoginFailedError extends ForumError {
+    constructor(reason) {
+        super(`Forum login failed: ${reason}`);
+        this.name = "LoginFailedError";
+    }
+}
+/** Разметка страницы не совпала с ожиданиями парсера. */
+export class ParseError extends ForumError {
+    constructor(what, url) {
+        super(`Could not parse ${what} at ${url}. The forum markup may have changed.`);
+        this.name = "ParseError";
+    }
+}
+/** Форум не отвечает (сработал ForumHealth): запросы временно не отправляются. */
+export class ForumUnavailableError extends ForumError {
+    retryInSec;
+    constructor(retryInSec) {
+        super(`The forum is not responding right now. Try again in ${retryInSec}s.`);
+        this.retryInSec = retryInSec;
+        this.name = "ForumUnavailableError";
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/forum/health.js

@@ -0,0 +1,60 @@
+import { createLogger } from "../logger.js";
+import { ForumUnavailableError } from "./errors.js";
+const logger = createLogger("forum-health");
+/**
+ * Circuit breaker для форума. Форум периодически лежит; без этого каждый вызов
+ * инструмента ждал бы таймауты всех повторов.
+ *
+ * - closed: запросы идут как обычно;
+ * - open: после `failureThreshold` неудачных запросов подряд форум считается
+ *   лежащим, запросы сразу получают ForumUnavailableError;
+ * - через `cooldownMs` пропускается один пробный запрос (half-open): успех
+ *   закрывает breaker, неудача снова открывает его на cooldown.
+ *
+ * Один экземпляр на процесс, общий для всех ForumHttp.
+ */
+export class ForumHealth {
+    failures = 0;
+    openUntil = 0;
+    probing = false;
+    threshold;
+    cooldownMs;
+    now;
+    constructor(options = {}) {
+        this.threshold = options.failureThreshold ?? 2;
+        this.cooldownMs = options.cooldownMs ?? 30_000;
+        this.now = options.now ?? Date.now;
+    }
+    /** Бросает ForumUnavailableError, если форум сейчас считается лежащим. */
+    check() {
+        if (this.failures < this.threshold)
+            return;
+        const wait = this.openUntil - this.now();
+        if (wait > 0 || this.probing) {
+            throw new ForumUnavailableError(Math.max(1, Math.ceil(Math.max(wait, 1000) / 1000)));
+        }
+        // Cooldown прошёл: пропускаем один пробный запрос.
+        this.probing = true;
+    }
+    success() {
+        if (this.failures >= this.threshold)
+            logger.info("Forum is back up");
+        this.failures = 0;
+        this.probing = false;
+    }
+    failure() {
+        this.failures++;
+        this.probing = false;
+        if (this.failures >= this.threshold) {
+            if (this.failures === this.threshold)
+                logger.warn(`Forum looks down, pausing requests for ${this.cooldownMs / 1000}s`);
+            this.openUntil = this.now() + this.cooldownMs;
+        }
+    }
+    get status() {
+        if (this.failures < this.threshold)
+            return { up: true };
+        return { up: false, retryInSec: Math.max(0, Math.ceil((this.openUntil - this.now()) / 1000)) };
+    }
+}
+//# sourceMappingURL=health.js.map

package/dist/forum/http.js

@@ -0,0 +1,138 @@
+import { createLogger } from "../logger.js";
+import { CookieJar } from "./cookie-jar.js";
+import { ForumError } from "./errors.js";
+import { ForumHealth } from "./health.js";
+const logger = createLogger("forum-http");
+const USER_AGENT = "mcgl-mcp/0.1 (+MCP forum tools)";
+const MAX_REDIRECTS = 5;
+/** Ответ, после которого GET имеет смысл повторить. */
+class RetryableError extends ForumError {
+}
+/**
+ * HTTP-клиент к форуму: свой CookieJar, общий RateLimiter, ручные редиректы
+ * (чтобы не терять Set-Cookie из 302 после логина), повторы и circuit breaker.
+ *
+ * - GET при сетевой ошибке, таймауте или 5xx повторяется (по умолчанию 3 попытки).
+ * - POST не повторяется: при обрыве неизвестно, дошёл ли запрос, а повтор
+ *   отправки поста создал бы дубль.
+ * - Если форум лежит (ForumHealth), запрос сразу падает с ForumUnavailableError.
+ *
+ * Один экземпляр = одна «браузерная сессия». Для анонимного чтения хватает
+ * одного общего, для каждого игрока нужен свой.
+ */
+export class ForumHttp {
+    env;
+    limiter;
+    jar = new CookieJar();
+    health;
+    retryDelaysMs;
+    constructor(env, limiter, options = {}) {
+        this.env = env;
+        this.limiter = limiter;
+        this.health = options.health ?? new ForumHealth();
+        this.retryDelaysMs = options.retryDelaysMs ?? [1000, 2000];
+    }
+    get(path) {
+        return this.withHealth(() => this.withRetries(path, () => this.request(path, { method: "GET" })));
+    }
+    postForm(path, fields, extraHeaders) {
+        const body = new URLSearchParams();
+        for (const [k, v] of Object.entries(fields))
+            if (v !== undefined)
+                body.append(k, String(v));
+        return this.withHealth(() => this.request(path, {
+            method: "POST",
+            headers: { ...extraHeaders, "content-type": "application/x-www-form-urlencoded; charset=utf-8" },
+            body: body.toString(),
+        }));
+    }
+    absoluteUrl(path) {
+        return new URL(path, this.env.baseUrl + "/").toString();
+    }
+    async withHealth(run) {
+        this.health.check();
+        try {
+            const page = await run();
+            this.health.success();
+            return page;
+        }
+        catch (error) {
+            // Форум ответил, но что-то не так (редиректы по кругу и т.п.) — он жив.
+            if (error instanceof RetryableError)
+                this.health.failure();
+            else
+                this.health.success();
+            throw error;
+        }
+    }
+    async withRetries(path, run) {
+        for (let attempt = 0;; attempt++) {
+            try {
+                return await run();
+            }
+            catch (error) {
+                const delay = this.retryDelaysMs[attempt];
+                if (!(error instanceof RetryableError) || delay === undefined)
+                    throw error;
+                logger.warn(`GET ${path} failed (${error.message}), retry ${attempt + 1}/${this.retryDelaysMs.length} in ${delay}ms`);
+                await new Promise((r) => setTimeout(r, delay));
+            }
+        }
+    }
+    async request(path, init) {
+        let url = this.absoluteUrl(path);
+        let current = init;
+        for (let hop = 0; hop <= MAX_REDIRECTS; hop++) {
+            const res = await this.limiter.schedule(() => this.fetchOnce(url, current));
+            this.jar.absorb(res.headers);
+            const location = res.headers.get("location");
+            if (res.status >= 300 && res.status < 400 && location) {
+                await res.body?.cancel();
+                url = new URL(location, url).toString();
+                // 301/302/303 после POST браузеры превращают в GET, повторяем это поведение.
+                current = res.status === 307 || res.status === 308 ? current : { method: "GET" };
+                continue;
+            }
+            const html = decode(await res.arrayBuffer(), res.headers.get("content-type"));
+            logger.debug(`${current.method} ${url} -> ${res.status}${hop ? ` (after ${hop} redirect(s) from ${init.method} ${path})` : ""}`);
+            if (res.status >= 500) {
+                throw new RetryableError(`Forum returned HTTP ${res.status} for ${url}`);
+            }
+            return { url, status: res.status, html };
+        }
+        throw new ForumError(`Too many redirects starting from ${path}`);
+    }
+    async fetchOnce(url, init) {
+        const headers = new Headers(init.headers);
+        headers.set("user-agent", USER_AGENT);
+        headers.set("accept", "text/html,application/xhtml+xml");
+        const cookie = this.jar.header();
+        if (cookie)
+            headers.set("cookie", cookie);
+        try {
+            return await fetch(url, {
+                ...init,
+                headers,
+                redirect: "manual",
+                signal: AbortSignal.timeout(this.env.timeoutMs),
+            });
+        }
+        catch (error) {
+            const timeout = error instanceof DOMException && error.name === "TimeoutError";
+            throw new RetryableError(timeout ? `Forum timed out: ${url}` : `Request to forum failed: ${url}`, {
+                cause: error,
+            });
+        }
+    }
+}
+/** Форум отдаёт UTF-8 и пишет charset в заголовке; на всякий случай уважаем его. */
+function decode(body, contentType) {
+    const charset = /charset=([^;]+)/i.exec(contentType ?? "")?.[1]?.trim() || "utf-8";
+    try {
+        return new TextDecoder(charset).decode(body);
+    }
+    catch {
+        return new TextDecoder("utf-8").decode(body);
+    }
+}
+//# sourceMappingURL=http.js.map

package/dist/forum/objects.js

@@ -0,0 +1,87 @@
+import { createLogger } from "../logger.js";
+const logger = createLogger("objects");
+/**
+ * Эндпоинт всплывающих подсказок форума: `/object/{id}/{type}`.
+ * Тип 1 — игрок, 2 — предмет (`?d=` — метадата), 3 — сообщество.
+ * Ответ — JS-объект в одинарных кавычках (форум делает ему eval), пустой ответ — нет такого объекта:
+ *   {'_type':'2','id':'41','title':'Золотой блок','info':'Используется для декора…'}
+ */
+export function parseObjectLiteral(raw) {
+    const body = raw.trim();
+    if (!body.startsWith("{"))
+        return undefined;
+    const result = {};
+    for (const [, key, value] of body.matchAll(/'([^']+)'\s*:\s*'((?:\\.|[^'\\])*)'/g)) {
+        result[key] = value.replace(/\\(.)/g, "$1");
+    }
+    return Object.keys(result).length ? result : undefined;
+}
+/** Маркер предмета в тексте поста, который ставит content.ts и раскрывает ItemResolver. */
+export const ITEM_TOKEN = /⟦item:(\d+):(\d+)⟧/g;
+export const itemToken = (id, meta) => `⟦item:${id}:${meta}⟧`;
+/** Легенда к окну крафта: список предметов через ";". */
+export const LEGEND_TOKEN = /⟦legend:([\d:;]+)⟧/g;
+export const legendToken = (items) => `⟦legend:${items.map(([i, m]) => `${i}:${m}`).join(";")}⟧`;
+/**
+ * Названия предметов по id и метадате. Предметы не меняются, поэтому кеш
+ * живёт весь процесс и общий для всех запросов. За один вызов resolve
+ * делается не больше `maxLookups` новых запросов к форуму; остальные
+ * предметы остаются в виде «item #id».
+ */
+export class ItemResolver {
+    http;
+    maxLookups;
+    cache = new Map();
+    constructor(http, maxLookups = 25) {
+        this.http = http;
+        this.maxLookups = maxLookups;
+    }
+    /** Подставляет названия вместо маркеров во всех переданных текстах. */
+    async resolve(texts) {
+        const wanted = new Set();
+        for (const t of texts) {
+            for (const [, id, meta] of t.matchAll(ITEM_TOKEN))
+                wanted.add(`${id}:${meta}`);
+            for (const [, list] of t.matchAll(LEGEND_TOKEN))
+                list.split(";").forEach((k) => wanted.add(k));
+        }
+        let budget = this.maxLookups;
+        const known = new Map();
+        for (const key of wanted) {
+            if (!this.cache.has(key)) {
+                if (budget-- <= 0)
+                    continue;
+                const [id, meta] = key.split(":").map(Number);
+                this.cache.set(key, this.fetchItem(id, meta));
+            }
+            known.set(key, await this.cache.get(key));
+        }
+        const shortKey = (key) => (key.endsWith(":0") ? key.slice(0, -2) : key);
+        const name = (key) => known.get(key)?.title ?? "item";
+        // "Золотой блок #41", "Красная шерсть #35:14", без названия — "item #41".
+        const label = (key) => `${name(key)} #${shortKey(key)}`;
+        return texts.map((t) => t
+            .replace(ITEM_TOKEN, (_, id, meta) => `[${label(`${id}:${meta}`)}]`)
+            .replace(LEGEND_TOKEN, (_, list) => list
+            .split(";")
+            .filter((k, i, all) => all.indexOf(k) === i)
+            .map((k) => `${shortKey(k)} = ${name(k)}`)
+            .join("\n")));
+    }
+    async fetchItem(id, meta) {
+        try {
+            const page = await this.http.get(`/object/${id}/2${meta ? `?d=${meta}` : ""}`);
+            const obj = parseObjectLiteral(page.html);
+            if (!obj?.title)
+                return undefined;
+            return { id, meta, title: obj.title, info: obj.info || undefined };
+        }
+        catch (error) {
+            // Не кешируем сбой сети: в следующий раз попробуем снова.
+            this.cache.delete(`${id}:${meta}`);
+            logger.warn(`Item ${id}:${meta} lookup failed`, error);
+            return undefined;
+        }
+    }
+}
+//# sourceMappingURL=objects.js.map