micro-models-agent 2.16.1 → 2.17.1

package/dist/modules/webui/settings-api.js

@@ -1,561 +0,0 @@
-import { redactContextSecrets } from "../../core/agent/context-log";
-import { readBodyError, sendJson } from "./util";
-import { readJsonBody } from "./body";
-import { DEFAULT_LSP_CONFIG } from "../lsp/config";
-/** Append-only категории памяти (зеркало `memory-commands.ts` / `MemoryStore`). */
-const MEMORY_CATEGORIES = ["conventions", "decisions", "errors", "facts"];
-function isCategory(value) {
-    return MEMORY_CATEGORIES.includes(value);
-}
-/** Режет append-only файл категории на записи с нумерацией от 1 (`- `-блоки). */
-function listEntries(markdown) {
-    const lines = markdown.split(/\r?\n/);
-    const entries = [];
-    for (const line of lines) {
-        if (line.startsWith("- "))
-            entries.push({ n: entries.length + 1, text: line });
-    }
-    return entries;
-}
-/** `GET /api/memory` — преференсы + записи по категориям (секреты вычищены). */
-export function handleMemoryGet(res, s) {
-    if (!s.memory) {
-        sendJson(res, 503, { error: "memory_unavailable" });
-        return;
-    }
-    const store = s.memory;
-    const preferences = {};
-    for (const [key, value] of Object.entries(store.getPreferences())) {
-        preferences[key] = redactContextSecrets(String(value));
-    }
-    const categories = MEMORY_CATEGORIES.map((name) => ({
-        name,
-        entries: listEntries(store.read(name)).map((e) => ({
-            n: e.n,
-            text: redactContextSecrets(e.text),
-        })),
-    }));
-    sendJson(res, 200, { preferences, categories });
-}
-/** `POST /api/memory {category, text}` — дописать запись. */
-export function handleMemoryPost(req, res, s) {
-    if (!s.memory) {
-        sendJson(res, 503, { error: "memory_unavailable" });
-        return;
-    }
-    const store = s.memory;
-    readJsonBody(req, s.maxBodyBytes)
-        .then((rec) => {
-        if (!rec) {
-            sendJson(res, 400, { ok: false, error: "invalid JSON" });
-            return;
-        }
-        const category = typeof rec.category === "string" ? rec.category : "";
-        const text = typeof rec.text === "string" ? rec.text.trim() : "";
-        if (!isCategory(category) || text.length === 0) {
-            sendJson(res, 400, { ok: false, error: "invalid-entry" });
-            return;
-        }
-        store.append(category, text);
-        sendJson(res, 200, { ok: true });
-    })
-        .catch((err) => {
-        readBodyError(req, res, err);
-    });
-}
-/** `DELETE /api/memory/:category/:n` — забыть n-ю запись. */
-export function handleMemoryDelete(res, category, nRaw, s) {
-    if (!s.memory) {
-        sendJson(res, 503, { error: "memory_unavailable" });
-        return;
-    }
-    if (!isCategory(category)) {
-        sendJson(res, 400, { ok: false, error: "invalid-category" });
-        return;
-    }
-    const n = parseInt(nRaw, 10);
-    if (!(n > 0) || !s.memory.deleteEntry(category, n)) {
-        sendJson(res, 404, { ok: false, error: "not_found" });
-        return;
-    }
-    sendJson(res, 200, { ok: true });
-}
-/** `GET /api/skills` — доступные скиллы с флагом загруженности. */
-export function handleSkillsGet(res, s) {
-    if (!s.skills) {
-        sendJson(res, 503, { error: "skills_unavailable" });
-        return;
-    }
-    const loaded = new Set(s.skills.getLoaded().map((skill) => skill.name));
-    const skills = s.skills.getAvailable().map((skill) => {
-        const info = { name: skill.name, enabled: loaded.has(skill.name) };
-        if (skill.description)
-            info.description = skill.description;
-        if (skill.sourcePath)
-            info.source = skill.sourcePath;
-        return info;
-    });
-    sendJson(res, 200, { skills });
-}
-/** Опциональные несекретные поля MCP для вида (держат гейт сложности). */
-function mcpViewOptionals(cfg) {
-    const out = {};
-    if (cfg.transport)
-        out.transport = cfg.transport;
-    if (cfg.command)
-        out.command = cfg.command;
-    if (cfg.url)
-        out.url = cfg.url;
-    if (cfg.args)
-        out.args = [...cfg.args];
-    if (cfg.timeout !== undefined)
-        out.timeout = cfg.timeout;
-    if (cfg.enabled !== undefined)
-        out.enabled = cfg.enabled;
-    return out;
-}
-function mcpList(s) {
-    const servers = s.config?.mcpServers ?? {};
-    return Object.entries(servers).map(([key, cfg]) => ({
-        id: key,
-        name: cfg.name || key,
-        status: cfg.enabled === false ? "disabled" : "enabled",
-        envKeys: cfg.env ? Object.keys(cfg.env) : [],
-        headerKeys: cfg.headers ? Object.keys(cfg.headers) : [],
-        ...mcpViewOptionals(cfg),
-    }));
-}
-/** `GET /api/plugins` — зарегистрированные плагины + настроенные MCP-серверы. */
-export function handlePluginsGet(res, s) {
-    if (!s.plugins) {
-        sendJson(res, 503, { error: "plugins_unavailable" });
-        return;
-    }
-    const plugins = s.plugins.getPluginInfos().map(({ plugin, source }) => {
-        const info = {
-            name: plugin.name,
-            enabled: true,
-            builtin: plugin.isBuiltin === true,
-        };
-        if (plugin.version)
-            info.version = plugin.version;
-        const src = source || plugin.source;
-        if (src)
-            info.source = src;
-        return info;
-    });
-    sendJson(res, 200, { plugins, mcp: mcpList(s) });
-}
-/**
- * `POST /api/mcp/:id {enabled}` — тоггл настроенного MCP-сервера.
- *
- * `config.mcpServers[id].enabled` — флаг, фильтруемый MCP-модулем на bootstrap,
- * так что смена персистится и вступает со следующего запуска (MCP-соединения
- * через `agent.reconfigure` не переподнимаются). Ответ несёт
- * `restartRequired: true`, чтобы UI так и сказал.
- */
-export function handleMcpToggle(req, res, id, s) {
-    if (!s.config) {
-        sendJson(res, 503, { error: "config_unavailable" });
-        return;
-    }
-    const config = s.config;
-    const entry = config.mcpServers?.[id];
-    if (!entry) {
-        sendJson(res, 404, { ok: false, error: "not_found" });
-        return;
-    }
-    readJsonBody(req, s.maxBodyBytes)
-        .then((rec) => {
-        if (!rec) {
-            sendJson(res, 400, { ok: false, error: "invalid JSON" });
-            return;
-        }
-        if (typeof rec.enabled !== "boolean") {
-            sendJson(res, 400, { ok: false, error: "invalid-enabled" });
-            return;
-        }
-        config.mcpServers[id] = { ...entry, enabled: rec.enabled };
-        let persisted = true;
-        try {
-            s.saveConfig?.(config);
-        }
-        catch {
-            persisted = false;
-        }
-        sendJson(res, 200, { ok: true, persisted, restartRequired: true, mcp: mcpList(s) });
-    })
-        .catch((err) => {
-        readBodyError(req, res, err);
-    });
-}
-/** Транспорты записи MCP-сервера (`MCPServerConfigEntry`). */
-const MCP_TRANSPORTS = ["stdio", "sse", "http"];
-function isRecord(value) {
-    return typeof value === "object" && value !== null && !Array.isArray(value);
-}
-function asStringArray(value) {
-    if (!Array.isArray(value))
-        return null;
-    if (!value.every((x) => typeof x === "string"))
-        return null;
-    return [...value];
-}
-function asStringRecord(value) {
-    if (!isRecord(value))
-        return null;
-    const out = {};
-    for (const [k, v] of Object.entries(value)) {
-        if (typeof v !== "string")
-            return null;
-        out[k] = v;
-    }
-    return out;
-}
-function validTimeout(value) {
-    return typeof value === "number" && Number.isInteger(value) && value >= 1000 && value <= 300000;
-}
-/** Проверка когерентности смёрженной MCP-записи: транспорт vs command/url + таймаут. */
-function validateMcpEntry(entry) {
-    const transport = entry.transport ?? "stdio";
-    if (!MCP_TRANSPORTS.includes(transport))
-        return "invalid-transport";
-    if (transport === "stdio") {
-        if (!entry.command?.trim())
-            return "command-required";
-    }
-    else if (!entry.url?.trim()) {
-        return "url-required";
-    }
-    if (entry.timeout !== undefined && !validTimeout(entry.timeout))
-        return "invalid-timeout";
-    return null;
-}
-/** Гоняет пополевые апплаеры в порядке таблицы; первая ошибка побеждает. */
-function applyFields(target, patch, appliers) {
-    for (const [key, apply] of Object.entries(appliers)) {
-        const value = patch[key];
-        if (value === undefined)
-            continue;
-        const error = apply(target, value);
-        if (error)
-            return error;
-    }
-    return null;
-}
-function setTrimmed(value, code, set, clear) {
-    if (typeof value !== "string")
-        return code;
-    if (value.trim())
-        set(value.trim());
-    else
-        clear();
-    return null;
-}
-/** Пополевые MCP-апплаеры (правило #17: таблица, без `if`-цепочки). */
-const MCP_FIELD_APPLIERS = {
-    name: (next, v) => {
-        if (typeof v !== "string" || !v.trim())
-            return "name-required";
-        next.name = v.trim();
-        return null;
-    },
-    transport: (next, v) => {
-        if (typeof v !== "string")
-            return "invalid-transport";
-        next.transport = v;
-        return null;
-    },
-    command: (next, v) => setTrimmed(v, "invalid-command", (t) => { next.command = t; }, () => { delete next.command; }),
-    url: (next, v) => setTrimmed(v, "invalid-url", (t) => { next.url = t; }, () => { delete next.url; }),
-    args: (next, v) => {
-        const args = asStringArray(v);
-        if (!args)
-            return "invalid-args";
-        next.args = args;
-        return null;
-    },
-    env: (next, v) => {
-        const env = asStringRecord(v);
-        if (!env)
-            return "invalid-env";
-        next.env = env;
-        return null;
-    },
-    headers: (next, v) => {
-        const headers = asStringRecord(v);
-        if (!headers)
-            return "invalid-headers";
-        next.headers = headers;
-        return null;
-    },
-    enabled: (next, v) => {
-        if (typeof v !== "boolean")
-            return "invalid-enabled";
-        next.enabled = v;
-        return null;
-    },
-    timeout: (next, v) => {
-        if (!validTimeout(v))
-            return "invalid-timeout";
-        next.timeout = v;
-        return null;
-    },
-};
-function applyMcpPatch(next, patch) {
-    return applyFields(next, patch, MCP_FIELD_APPLIERS);
-}
-/**
- * Чистое создание: валидирует `input` и кладёт запись под тримменным именем.
- * Секреты значениями не эхом — вызывающий рендерит маскированный `mcpList`-вид.
- */
-export function createMcpServer(config, input) {
-    if (!isRecord(input))
-        return { ok: false, error: "invalid-input" };
-    const name = typeof input.name === "string" ? input.name.trim() : "";
-    if (!name)
-        return { ok: false, error: "name-required" };
-    if (!config.mcpServers)
-        config.mcpServers = {};
-    if (config.mcpServers[name])
-        return { ok: false, error: "name-conflict" };
-    const next = { name };
-    const patchError = applyMcpPatch(next, { ...input, name });
-    if (patchError)
-        return { ok: false, error: patchError };
-    const coherent = validateMcpEntry(next);
-    if (coherent)
-        return { ok: false, error: coherent };
-    config.mcpServers[name] = next;
-    return { ok: true, id: name };
-}
-/** Чистая полная/частичная правка MCP-записи (ключ остаётся `id`). */
-export function updateMcpServer(config, id, patch) {
-    const current = config.mcpServers?.[id];
-    if (!current)
-        return { ok: false, error: "not_found" };
-    if (!isRecord(patch))
-        return { ok: false, error: "invalid-input" };
-    const next = { ...current };
-    const patchError = applyMcpPatch(next, patch);
-    if (patchError)
-        return { ok: false, error: patchError };
-    const coherent = validateMcpEntry(next);
-    if (coherent)
-        return { ok: false, error: coherent };
-    config.mcpServers[id] = next;
-    return { ok: true, id };
-}
-/** Чистое удаление MCP-записи. */
-export function deleteMcpServer(config, id) {
-    if (!config.mcpServers?.[id])
-        return { ok: false, error: "not_found" };
-    delete config.mcpServers[id];
-    return { ok: true, id };
-}
-/** Чистое чтение: таблица LSP-серверов (фолбэк — встроенные дефолты). */
-export function listLspServers(config) {
-    const lsp = config.lsp ?? DEFAULT_LSP_CONFIG;
-    return Object.entries(lsp.servers).map(([lang, srv]) => {
-        const view = {
-            lang,
-            command: srv.command,
-            timeout: srv.timeout ?? lsp.timeout,
-            autoInstall: srv.autoInstall ?? false,
-            enabled: lsp.enabled !== false && srv.enabled !== false,
-        };
-        if (srv.args)
-            view.args = [...srv.args];
-        return view;
-    });
-}
-/** Пополевые LSP-апплаеры (правило #17: таблица, без `if`-цепочки). */
-const LSP_FIELD_APPLIERS = {
-    enabled: (srv, v) => {
-        if (typeof v !== "boolean")
-            return "invalid-enabled";
-        srv.enabled = v;
-        return null;
-    },
-    command: (srv, v) => {
-        if (typeof v !== "string" || !v.trim())
-            return "invalid-command";
-        srv.command = v.trim();
-        return null;
-    },
-    args: (srv, v) => {
-        const args = asStringArray(v);
-        if (!args)
-            return "invalid-args";
-        srv.args = args;
-        return null;
-    },
-    timeout: (srv, v) => {
-        if (!validTimeout(v))
-            return "invalid-timeout";
-        srv.timeout = v;
-        return null;
-    },
-};
-/** Пополевой LSP-патч; возвращает код ошибки или null. */
-function applyLspPatch(srv, patch) {
-    return applyFields(srv, patch, LSP_FIELD_APPLIERS);
-}
-/** Чистая правка одного LSP-сервера (секцию `lsp` поднимает из дефолтов, если нет). */
-export function updateLspServer(config, lang, patch) {
-    if (!isRecord(patch))
-        return { ok: false, error: "invalid-input" };
-    if (!config.lsp)
-        config.lsp = structuredClone(DEFAULT_LSP_CONFIG);
-    const srv = config.lsp.servers[lang];
-    if (!srv)
-        return { ok: false, error: "not_found" };
-    const patchError = applyLspPatch(srv, patch);
-    if (patchError)
-        return { ok: false, error: patchError };
-    return { ok: true, lang };
-}
-/** Best-effort персист; бросающий `saveConfig` не должен стать 500-й. */
-function persistConfig(s, config) {
-    try {
-        s.saveConfig?.(config);
-        return true;
-    }
-    catch {
-        return false;
-    }
-}
-/**
- * Общий конверт пишущих точек конфига: 503 без конфига, 400 на битом JSON,
- * затем чистая мутация. Успех персистится и флажит `restartRequired`
- * (MCP/LSP-соединения (пере-)поднимаются только на bootstrap).
- */
-function handleConfigWrite(req, res, s, mutate, view) {
-    if (!s.config) {
-        sendJson(res, 503, { error: "config_unavailable" });
-        return;
-    }
-    const config = s.config;
-    readJsonBody(req, s.maxBodyBytes)
-        .then((rec) => {
-        if (!rec) {
-            sendJson(res, 400, { ok: false, error: "invalid JSON" });
-            return;
-        }
-        const outcome = mutate(config, rec);
-        if (!outcome.ok) {
-            sendJson(res, outcome.status, { ok: false, error: outcome.error });
-            return;
-        }
-        const persisted = persistConfig(s, config);
-        sendJson(res, 200, { ok: true, persisted, restartRequired: true, ...view(config, s) });
-    })
-        .catch((err) => {
-        readBodyError(req, res, err);
-    });
-}
-/** Маппит чистый `McpWriteResult` на исход конверта (разводка 400/404). */
-function mcpOutcome(result) {
-    if (result.ok)
-        return { ok: true };
-    return { ok: false, status: result.error === "not_found" ? 404 : 400, error: result.error };
-}
-/**
- * `POST /api/mcp` — создать настроенный MCP-сервер.
- * Персистится и вступает со следующего запуска (`restartRequired: true`).
- */
-export function handleMcpCreate(req, res, s) {
-    handleConfigWrite(req, res, s, (config, rec) => mcpOutcome(createMcpServer(config, rec)), (_config, state) => ({ mcp: mcpList(state) }));
-}
-/** `PUT /api/mcp/:id` — полная/частичная правка настроенного MCP-сервера. */
-export function handleMcpUpdate(req, res, id, s) {
-    handleConfigWrite(req, res, s, (config, rec) => mcpOutcome(updateMcpServer(config, id, rec)), (_config, state) => ({ mcp: mcpList(state) }));
-}
-/** `DELETE /api/mcp/:id` — снять настроенный MCP-сервер. */
-export function handleMcpDelete(res, id, s) {
-    if (!s.config) {
-        sendJson(res, 503, { error: "config_unavailable" });
-        return;
-    }
-    const result = deleteMcpServer(s.config, id);
-    if (!result.ok) {
-        sendJson(res, 404, { ok: false, error: result.error });
-        return;
-    }
-    const persisted = persistConfig(s, s.config);
-    sendJson(res, 200, { ok: true, persisted, restartRequired: true, mcp: mcpList(s) });
-}
-/** `GET /api/lsp` — таблица LSP-серверов. */
-export function handleLspGet(res, s) {
-    if (!s.config) {
-        sendJson(res, 503, { error: "config_unavailable" });
-        return;
-    }
-    sendJson(res, 200, { servers: listLspServers(s.config) });
-}
-/** `PUT /api/lsp/:lang {enabled?,timeout?,command?,args?}` — правит один LSP-сервер. */
-export function handleLspUpdate(req, res, lang, s) {
-    handleConfigWrite(req, res, s, (config, rec) => {
-        const result = updateLspServer(config, lang, rec);
-        if (result.ok)
-            return { ok: true };
-        return { ok: false, status: result.error === "not_found" ? 404 : 400, error: result.error };
-    }, (config) => ({ servers: listLspServers(config) }));
-}
-/** Точные роуты настроек `METHOD путь` (правило #17: карта хендлеров, без `if`). */
-const SETTINGS_EXACT = {
-    "GET /api/memory": (_req, res, _param, s) => handleMemoryGet(res, s),
-    "POST /api/memory": (req, res, _param, s) => handleMemoryPost(req, res, s),
-    "GET /api/skills": (_req, res, _param, s) => handleSkillsGet(res, s),
-    "GET /api/plugins": (_req, res, _param, s) => handlePluginsGet(res, s),
-};
-/** Префиксные роуты настроек с одним параметром пути (правило #17). */
-const SETTINGS_PREFIX = [
-    {
-        method: "DELETE",
-        prefix: "/api/memory/",
-        handle: (_req, res, param, s) => {
-            const slash = param.indexOf("/");
-            handleMemoryDelete(res, slash >= 0 ? decodeURIComponent(param.slice(0, slash)) : "", slash >= 0 ? decodeURIComponent(param.slice(slash + 1)) : "", s);
-        },
-    },
-    {
-        method: "POST",
-        prefix: "/api/mcp/",
-        handle: (req, res, param, s) => handleMcpToggle(req, res, decodeURIComponent(param), s),
-    },
-    {
-        method: "PUT",
-        prefix: "/api/mcp/",
-        handle: (req, res, param, s) => handleMcpUpdate(req, res, decodeURIComponent(param), s),
-    },
-    {
-        method: "DELETE",
-        prefix: "/api/mcp/",
-        handle: (_req, res, param, s) => handleMcpDelete(res, decodeURIComponent(param), s),
-    },
-    {
-        method: "PUT",
-        prefix: "/api/lsp/",
-        handle: (req, res, param, s) => handleLspUpdate(req, res, decodeURIComponent(param), s),
-    },
-];
-/**
- * Диспатч роутов настроек. Возвращает, обработан ли запрос, чтобы `server.ts`
- * держал плоскую цепочку без дубля парсинга путей.
- */
-export function handleSettingsApi(req, res, reqUrl, s) {
-    const p = reqUrl.pathname;
-    const exact = SETTINGS_EXACT[`${req.method} ${p}`];
-    if (exact) {
-        exact(req, res, "", s);
-        return true;
-    }
-    for (const route of SETTINGS_PREFIX) {
-        if (req.method === route.method && p.startsWith(route.prefix)) {
-            route.handle(req, res, p.slice(route.prefix.length), s);
-            return true;
-        }
-    }
-    return false;
-}