micro-models-agent 2.16.1 → 2.17.1

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

@@ -1,201 +0,0 @@
-import { getFlatDicts, setLocale } from "../../i18n";
-import { applyAnswersToConfig } from "../setup/apply";
-import { SETUP_LANGUAGES } from "../setup/answers";
-import { fetchProviderModels, scanLocalServers, testProviderChat, } from "../setup/discovery";
-import { broadcast } from "./state";
-import { readBody, readBodyError, sendJson } from "./util";
-import { readJsonBody } from "./body";
-import { persistAndReconfigure } from "./persist";
-function str(rec, key) {
-    const v = rec[key];
-    return typeof v === "string" ? v.trim() : "";
-}
-/** Положительный int, числовая строка принимается; `null` — мусор. */
-function positiveInt(rec, key) {
-    const v = rec[key];
-    const n = typeof v === "number" ? v : typeof v === "string" ? Number(v) : NaN;
-    return Number.isInteger(n) && n > 0 ? n : null;
-}
-/** Валидирует тело `POST /api/setup`; `null` — реджект с 400. */
-export function parseSetupAnswers(rec) {
-    const provider = str(rec, "provider");
-    const apiBase = str(rec, "apiBase");
-    const model = str(rec, "model");
-    if (!provider || !apiBase || !model)
-        return null;
-    const contextWindow = positiveInt(rec, "contextWindow");
-    const maxToolIterations = positiveInt(rec, "maxToolIterations");
-    if (contextWindow === null || maxToolIterations === null)
-        return null;
-    const locale = str(rec, "locale");
-    if (!SETUP_LANGUAGES.some((l) => l.value === locale))
-        return null;
-    const flags = ["securityBashBlock", "securityFlagsBlock", "securityPathsRestrict"];
-    for (const key of flags) {
-        if (typeof rec[key] !== "boolean")
-            return null;
-    }
-    const apiKey = typeof rec.apiKey === "string" && rec.apiKey.trim() ? rec.apiKey.trim() : "not-needed";
-    return {
-        provider,
-        apiBase,
-        apiKey,
-        model,
-        contextWindow,
-        maxToolIterations,
-        locale,
-        securityBashBlock: rec.securityBashBlock,
-        securityFlagsBlock: rec.securityFlagsBlock,
-        securityPathsRestrict: rec.securityPathsRestrict,
-    };
-}
-/** `GET /api/setup` — нужен ли сетап, плюс статика визарда. */
-export function handleSetupGet(res, s) {
-    sendJson(res, 200, {
-        required: s.setupRequired,
-        languages: s.setup?.languages ?? [],
-        providers: s.setup?.providers ?? [],
-        defaults: s.setup?.defaults ?? { contextWindow: 0, maxToolIterations: 0 },
-    });
-}
-/** `POST /api/setup/scan` — проб известных локальных OpenAI-совместимых серверов. */
-export function handleSetupScan(req, res, s) {
-    readBody(req, s.maxBodyBytes)
-        .then(async () => {
-        const servers = await scanLocalServers();
-        sendJson(res, 200, { servers });
-    })
-        .catch((err) => {
-        readBodyError(req, res, err);
-    });
-}
-/** `POST /api/setup/models {baseUrl, apiKey}` — id моделей провайдера. */
-export function handleSetupModels(req, res, s) {
-    readJsonBody(req, s.maxBodyBytes)
-        .then(async (rec) => {
-        if (!rec) {
-            sendJson(res, 400, { ok: false, error: "invalid JSON" });
-            return;
-        }
-        const baseUrl = str(rec, "baseUrl");
-        if (!baseUrl) {
-            sendJson(res, 400, { ok: false, error: "invalid-base-url" });
-            return;
-        }
-        const models = await fetchProviderModels(baseUrl, str(rec, "apiKey"));
-        sendJson(res, 200, { models });
-    })
-        .catch((err) => {
-        readBodyError(req, res, err);
-    });
-}
-/** `POST /api/setup/test {baseUrl, apiKey, model}` — дешёвый чат-проб. */
-export function handleSetupTest(req, res, s) {
-    readJsonBody(req, s.maxBodyBytes)
-        .then(async (rec) => {
-        if (!rec) {
-            sendJson(res, 400, { ok: false, error: "invalid JSON" });
-            return;
-        }
-        const baseUrl = str(rec, "baseUrl");
-        const model = str(rec, "model");
-        if (!baseUrl || !model) {
-            sendJson(res, 400, { ok: false, error: "invalid-test-request" });
-            return;
-        }
-        const ok = await testProviderChat(baseUrl, str(rec, "apiKey"), model);
-        sendJson(res, 200, { ok });
-    })
-        .catch((err) => {
-        readBodyError(req, res, err);
-    });
-}
-/**
- * `POST /api/setup/locale {locale}` — переключает локаль i18n процесса, чтобы
- * следующие шаги визарда локализовались. Не персистится (финал `POST /api/setup`
- * пишет выбранную локаль в конфиг).
- */
-export function handleSetupLocale(req, res, s) {
-    readJsonBody(req, s.maxBodyBytes)
-        .then((rec) => {
-        if (!rec) {
-            sendJson(res, 400, { ok: false, error: "invalid JSON" });
-            return;
-        }
-        const locale = str(rec, "locale");
-        if (!SETUP_LANGUAGES.some((l) => l.value === locale)) {
-            sendJson(res, 400, { ok: false, error: "unsupported-locale" });
-            return;
-        }
-        setLocale(locale);
-        sendJson(res, 200, { ok: true, locale, dicts: getFlatDicts() });
-    })
-        .catch((err) => {
-        readBodyError(req, res, err);
-    });
-}
-/** `POST /api/setup` — валидация, применение, персист, reconfigure, снятие гейта. */
-export function handleSetupPost(req, res, s) {
-    if (!s.config) {
-        sendJson(res, 503, { error: "config_unavailable" });
-        return;
-    }
-    if (!s.setupRequired) {
-        sendJson(res, 409, { error: "already_configured" });
-        return;
-    }
-    const config = s.config;
-    readJsonBody(req, s.maxBodyBytes)
-        .then(async (rec) => {
-        if (!rec) {
-            sendJson(res, 400, { ok: false, error: "invalid JSON" });
-            return;
-        }
-        const answers = parseSetupAnswers(rec);
-        if (!answers) {
-            sendJson(res, 400, { ok: false, error: "invalid-answers" });
-            return;
-        }
-        applyAnswersToConfig(config, answers);
-        setLocale(config.locale);
-        const { persisted, warning } = await persistAndReconfigure(s, config);
-        s.setupRequired = false;
-        broadcast({ type: "setup_done", ts: Date.now() }, s);
-        const body = { ok: true, persisted };
-        if (warning)
-            body.warning = warning;
-        sendJson(res, 200, body);
-    })
-        .catch((err) => {
-        readBodyError(req, res, err);
-    });
-}
-/** Диспатч `/api/setup*`; возвращает, обработан ли запрос. */
-export function handleSetupApi(req, res, reqUrl, s) {
-    const p = reqUrl.pathname;
-    if (p === "/api/setup" && req.method === "GET") {
-        handleSetupGet(res, s);
-        return true;
-    }
-    if (p === "/api/setup" && req.method === "POST") {
-        handleSetupPost(req, res, s);
-        return true;
-    }
-    if (p === "/api/setup/scan" && req.method === "POST") {
-        handleSetupScan(req, res, s);
-        return true;
-    }
-    if (p === "/api/setup/models" && req.method === "POST") {
-        handleSetupModels(req, res, s);
-        return true;
-    }
-    if (p === "/api/setup/test" && req.method === "POST") {
-        handleSetupTest(req, res, s);
-        return true;
-    }
-    if (p === "/api/setup/locale" && req.method === "POST") {
-        handleSetupLocale(req, res, s);
-        return true;
-    }
-    return false;
-}

package/dist/modules/webui/state.js

@@ -1,74 +0,0 @@
-import { MAX_BODY_BYTES } from "./limits";
-import { readEnv } from "../../config/env";
-/** Только положительный int; мусор даёт фолбэк 5. */
-export function parseMaxClients(raw) {
-    const n = Number(raw);
-    return Number.isInteger(n) && n > 0 ? n : 5;
-}
-/** Свежее состояние с env-дефолтами (хост, токен, капы). */
-export function createWebUiState() {
-    return {
-        server: null,
-        starting: null,
-        url: "",
-        host: readEnv("WEBUI_HOST") || "127.0.0.1",
-        token: readEnv("WEBUI_TOKEN") || null,
-        clients: new Set(),
-        bridge: null,
-        busy: false,
-        agentRunning: false,
-        turnToken: null,
-        lastPostTs: 0,
-        minPostIntervalMs: 500,
-        historyTail: 200,
-        maxBodyBytes: MAX_BODY_BYTES,
-        maxClients: parseMaxClients(readEnv("WEBUI_MAX_CLIENTS")),
-        pendingQuestions: new Map(),
-        setupRequired: false,
-    };
-}
-/** Шлёт событие всем SSE-клиентам (с backpressure-дропом зависших). */
-export function broadcast(ev, s) {
-    // Штампуем активную сессию на каждое событие, чтобы клиент клал стрим
-    // в правильную вкладку. Событие вправе переопределить явно.
-    const data = s.activeSessionId ? { sessionId: s.activeSessionId, ...ev } : ev;
-    const payload = `event: ${ev.type}\ndata: ${JSON.stringify(data)}\n\n`;
-    for (const client of s.clients) {
-        // Backpressure: `false` — буфер сокета полон (медленный/виснущий читатель).
-        // Дропаем клиента, а не копим события безгранично.
-        try {
-            if (!client.write(payload)) {
-                s.clients.delete(client);
-                client.end();
-            }
-        }
-        catch {
-            s.clients.delete(client);
-        }
-    }
-}
-/**
- * Атомарно резервирует single-flight слот, возвращает токен владения.
- *
- * Звать СИНХРОННО в том же тике, что пречек busy: любой `await` между чеком
- * и резервом даст двум конкурентным сабмитам оба выиграть. Токен явно фиксирует
- * владельца сброса — поздний колбэк провала прошлого хода чужой резерв не снесёт.
- */
-export function reserveBusy(s) {
-    const token = {};
-    s.turnToken = token;
-    s.busy = true;
-    return token;
-}
-/**
- * Отпускает слот, только если `token` всё ещё владеет им. Возвращает, был ли
- * вызывающий владельцем (чтобы скипнуть дублирующий бродкаст `state`, когда
- * форвардерный `turn_end` флаг уже сбросил).
- */
-export function releaseBusy(s, token) {
-    if (s.turnToken !== token)
-        return false;
-    s.turnToken = null;
-    s.busy = false;
-    return true;
-}

package/dist/modules/webui/util.js

@@ -1,261 +0,0 @@
-// Транспортные хелперы сервера `mma web` (auth, тела, JSON, single-flight сабмита).
-/**
- * Вынесены из `server.ts`, чтобы каждый файл был сильно меньше бюджета 300 строк
- * (правило #1). Чистая обвязка запрос/ответ — без переходов состояния приложения.
- */
-import { exec } from "node:child_process";
-import { timingSafeEqual } from "node:crypto";
-import { errMsg } from "../../utils/error";
-import { redactContextSecrets } from "../../core/agent/context-log";
-import { broadcast, releaseBusy, reserveBusy } from "./state";
-import { MAX_BODY_BYTES } from "./limits";
-import { readEnv } from "../../config/env";
-export { MAX_BODY_BYTES } from "./limits";
-/** Жёсткий кап текста одного сообщения, независимый от капа тела транспорта. */
-export const MAX_MESSAGE_CHARS = 32 * 1024;
-/** Максимум картинок на сообщение (по дизайну ≤3). */
-export const MAX_IMAGES = 3;
-/** Максимум размера одного `data:image/...` URL (по дизайну ~6MB). */
-export const MAX_IMAGE_DATA_URL_BYTES = 6 * 1024 * 1024;
-/** Бросается из readBody при превышении капа (маппится в HTTP 413). */
-export class BodyTooLargeError extends Error {
-    constructor() {
-        super("body too large");
-        this.name = "BodyTooLargeError";
-    }
-}
-/** True для loopback-хостов. */
-export function isLoopback(host) {
-    return host === "127.0.0.1" || host === "localhost" || host === "::1";
-}
-/** Сравнение строк за константное время; разные длины коротко замыкаются (timingSafeEqual бросает). */
-function safeEqual(a, b) {
-    const ab = Buffer.from(a);
-    const bb = Buffer.from(b);
-    if (ab.length !== bb.length)
-        return false;
-    return timingSafeEqual(ab, bb);
-}
-/** Имя HttpOnly-куки, несущей веб-токен для GET-навигаций. */
-const AUTH_COOKIE = "mma_web_auth";
-/** Читает значение куки из сырого заголовка `Cookie:`; битые кодировки дают null. */
-function cookieValue(header, name) {
-    if (!header)
-        return null;
-    for (const part of header.split(";")) {
-        const eq = part.indexOf("=");
-        if (eq === -1)
-            continue;
-        if (part.slice(0, eq).trim() === name) {
-            const raw = part.slice(eq + 1).trim();
-            try {
-                return decodeURIComponent(raw);
-            }
-            catch {
-                return null;
-            }
-        }
-    }
-    return null;
-}
-/** Токен-auth HTTP-поверхностей (заголовок `x-mma-token`, `?token=` или кука); без токена — разрешено. */
-export function checkAuth(req, reqUrl, s) {
-    if (!s.token)
-        return true;
-    const header = req.headers["x-mma-token"];
-    if (typeof header === "string" && safeEqual(header, s.token))
-        return true;
-    const query = reqUrl.searchParams.get("token");
-    if (query !== null && safeEqual(query, s.token))
-        return true;
-    const cookie = cookieValue(req.headers.cookie, AUTH_COOKIE);
-    return cookie !== null && safeEqual(cookie, s.token);
-}
-/**
- * Выдаёт браузеру same-site куку с токеном, чтобы plain-навигация
- * `<a target="_blank" href="/api/file?...">` (не умеющая ставить заголовок
- * `x-mma-token`) всё равно аутентифицировалась. `SameSite=Strict` — кросс-сайт
- * запрос её никогда не несёт, так что CSRF-поверхности не добавляется.
- */
-export function setAuthCookie(res, s) {
-    if (!s.token)
-        return;
-    res.setHeader("Set-Cookie", `${AUTH_COOKIE}=${encodeURIComponent(s.token)}; Path=/; HttpOnly; SameSite=Strict`);
-}
-/** Отклоняет кросс-доменные записи из браузера (CSRF-закалка). */
-export function sameOrigin(req, reqUrl) {
-    const origin = req.headers.origin;
-    if (!origin)
-        return true; // curl / same-origin GET
-    try {
-        return new URL(String(origin)).host === reqUrl.host;
-    }
-    catch {
-        return false;
-    }
-}
-/** Отправляет JSON-ответ со статусом. */
-export function sendJson(res, status, body) {
-    res.writeHead(status, { "Content-Type": "application/json; charset=utf-8" });
-    res.end(JSON.stringify(body));
-}
-/**
- * Буферизует тело запроса до `cap`. На переполнении реджектит `BodyTooLargeError`
- * БЕЗ убийства сокета: вызывающий владеет ответом 413 и рвёт запрос только
- * после флаша ответа — иначе клиент получит socket error вместо 413.
- */
-export function readBody(req, cap = MAX_BODY_BYTES) {
-    return new Promise((resolve, reject) => {
-        let size = 0;
-        let settled = false;
-        const chunks = [];
-        req.on("data", (chunk) => {
-            if (settled)
-                return;
-            size += chunk.length;
-            if (size > cap) {
-                settled = true;
-                reject(new BodyTooLargeError());
-                return;
-            }
-            chunks.push(chunk);
-        });
-        req.on("end", () => {
-            if (!settled)
-                resolve(Buffer.concat(chunks).toString("utf8"));
-        });
-        req.on("error", (err) => {
-            if (!settled) {
-                settled = true;
-                reject(err);
-            }
-        });
-    });
-}
-/** Достаёт `{ text, images }` из распарсенного тела; битый JSON и пусто — разные ошибки. */
-export function parseMessageBody(raw) {
-    let parsed;
-    try {
-        parsed = JSON.parse(raw);
-    }
-    catch {
-        return { error: "invalid JSON" };
-    }
-    const rec = typeof parsed === "object" && parsed !== null ? parsed : {};
-    const text = (typeof rec.text === "string" ? rec.text : "").slice(0, MAX_MESSAGE_CHARS);
-    const rawImages = Array.isArray(rec.images) ? rec.images : [];
-    if (rawImages.length > MAX_IMAGES)
-        return { error: "too many images" };
-    const images = [];
-    for (const img of rawImages) {
-        if (typeof img !== "string" || !img.startsWith("data:image/")) {
-            return { error: "invalid image" };
-        }
-        if (Buffer.byteLength(img, "utf8") > MAX_IMAGE_DATA_URL_BYTES) {
-            return { error: "image too large" };
-        }
-        images.push(img);
-    }
-    if (text.trim().length === 0 && images.length === 0)
-        return { error: "empty" };
-    return { text, images };
-}
-/**
- * Вычищает credentials из текста ошибки перед укладкой в SSE-пейлоад.
- * Переиспользует `redactContextSecrets` (точечная редактура) — общий
- * `sanitizeLogMessage` покалечил бы обычный текст, а веб-UI показывает их людям.
- */
-export function scrubError(err) {
-    return redactContextSecrets(errMsg(err));
-}
-/** Маппит провал чтения тела в ответ; переполненные получают flush-safe 413. */
-export function readBodyError(req, res, err) {
-    if (err instanceof BodyTooLargeError) {
-        res.writeHead(413, { "Content-Type": "application/json; charset=utf-8" });
-        // Уничтожаем запрос только после флаша 413; убийство раньше —
-        // и клиент видит socket error вместо статуса.
-        res.end(JSON.stringify({ error: "body too large" }), () => req.destroy());
-        return;
-    }
-    sendJson(res, 400, { error: "bad request" });
-}
-/**
- * `POST /api/message`: резервирует single-flight слот и отдаёт хосту.
- *
- * Инвариант single-flight: пречек busy и {@link reserveBusy} — в ОДИН
- * синхронный тик (без `await` между), иначе два конкурентных POST оба пройдут.
- * `bridge.isBusy()` следит за реально бегущим ходом (`agentRunning`) отдельно
- * от UI-резервации (`s.busy`) — поэтому сабмит владельца сбрасывает собственный
- * `isBusy()`-гард хоста. Форвардерный `turn_end` — единственный сброс для
- * стартовавшего хода; `releaseBusy` покрывает сабмит, так и не стартовавший.
- */
-export function handleMessagePost(req, res, s) {
-    if (s.setupRequired) {
-        sendJson(res, 409, { error: "setup_required" });
-        return;
-    }
-    if (!s.bridge) {
-        sendJson(res, 503, { error: "no_bridge" });
-        return;
-    }
-    if (s.busy || s.bridge.isBusy()) {
-        sendJson(res, 409, { error: "busy" });
-        return;
-    }
-    if (s.minPostIntervalMs > 0 && Date.now() - s.lastPostTs < s.minPostIntervalMs) {
-        sendJson(res, 429, { error: "rate_limited" });
-        return;
-    }
-    const bridge = s.bridge;
-    const token = reserveBusy(s);
-    broadcast({ type: "state", ts: Date.now(), busy: true }, s);
-    readBody(req, s.maxBodyBytes)
-        .then((raw) => {
-        const body = parseMessageBody(raw);
-        if ("error" in body) {
-            if (releaseBusy(s, token)) {
-                broadcast({ type: "state", ts: Date.now(), busy: false }, s);
-            }
-            sendJson(res, 400, { error: body.error });
-            return;
-        }
-        s.lastPostTs = Date.now();
-        const run = Promise.resolve(bridge.submit(body.text, { images: body.images }));
-        run.catch((err) => {
-            // Единственный владелец ошибки: для любого реально стартовавшего хода
-            // форвардер эмитит `turn_end {success:false}` и первым чистит резерв,
-            // так что `releaseBusy` здесь вернёт false и второй `error` слать НЕЛЬЗЯ
-            // (браузер показал бы две строки). `error` репортит только сабмит,
-            // зареджекченный до начала хода (резерв ещё наш).
-            if (releaseBusy(s, token)) {
-                broadcast({ type: "error", ts: Date.now(), error: scrubError(err) }, s);
-                broadcast({ type: "state", ts: Date.now(), busy: false }, s);
-            }
-        });
-        sendJson(res, 202, { ok: true });
-    })
-        .catch((err) => {
-        if (releaseBusy(s, token)) {
-            broadcast({ type: "state", ts: Date.now(), busy: false }, s);
-        }
-        readBodyError(req, res, err);
-    });
-}
-/** Best-effort открытие UI в браузере по умолчанию (MMA_WEBUI_OPEN=0 отключает). */
-export function tryOpenBrowser(url) {
-    if (readEnv("WEBUI_OPEN") === "0")
-        return;
-    try {
-        const platform = process.platform;
-        const cmd = platform === "win32"
-            ? `start "" "${url}"`
-            : platform === "darwin"
-                ? `open "${url}"`
-                : `xdg-open "${url}"`;
-        const child = exec(cmd, { windowsHide: true });
-        child.unref?.();
-    }
-    catch {
-        /* best-effort — открытие браузера не должно ломать старт */
-    }
-}

package/dist/output/bus.js

@@ -1,37 +0,0 @@
-/** Шина событий вывода. Упавший подписчик шину не роняет. */
-export class OutputBus {
-    seq = 0;
-    subs = new Set();
-    /** Подписка; возвращает отписку. */
-    subscribe(fn) {
-        this.subs.add(fn);
-        return () => this.subs.delete(fn);
-    }
-    /** Эмит события; проставляет id/ts и возвращает полное событие. */
-    emit(ev) {
-        const full = { ...ev, id: ++this.seq, ts: Date.now() };
-        for (const fn of [...this.subs]) {
-            try {
-                fn(full);
-            }
-            catch {
-                /* a subscriber must not break the bus */
-            }
-        }
-        return full;
-    }
-    /** Короткий эмит log-события. */
-    log(level, source, text, data) {
-        return this.emit({ level, source, kind: "log", text, data });
-    }
-    /**
-     * Хук изоляции тестов: сбрасывает подписчиков и счётчик id.
-     * В прод-коде не вызывать.
-     */
-    reset() {
-        this.subs.clear();
-        this.seq = 0;
-    }
-}
-/** Шина по умолчанию для всего приложения. */
-export const defaultOutputBus = new OutputBus();