micro-models-agent 2.16.0 → 2.17.1

package/dist/modules/webui/run-agent.js

@@ -1,81 +0,0 @@
-import { broadcast } from "./state";
-import { captureUsage, planEventFor } from "./host-state";
-import { cancelPendingQuestions } from "./prompt-io";
-/** Строит раннер: матчинг id тул-событий, флаг прерывания, захват usage. */
-export function makeRunAgent(deps) {
-    const { agent, state, forwarder } = deps;
-    // `ToolEvent` ориентирован на рендерер и id не несёт. Синтезируем по одному
-    // на `start` и матчим на `end` (LIFO по имени тула), чтобы браузер спарил
-    // карточки tool_start/tool_end.
-    const pendingIds = new Map();
-    let toolSeq = 0;
-    const startId = (tool) => {
-        const id = `t${++toolSeq}`;
-        const stack = pendingIds.get(tool) ?? [];
-        stack.push(id);
-        pendingIds.set(tool, stack);
-        return id;
-    };
-    const endId = (tool) => pendingIds.get(tool)?.pop() ?? `t-stray-${++toolSeq}`;
-    const callFor = (ev, id) => ({
-        id,
-        name: ev.tool,
-        arguments: ev.args,
-    });
-    const resultFor = (ev) => ({
-        success: !ev.error,
-        output: ev.output ?? "",
-    });
-    // У `AgentResult` нет поля `interrupted`, а `agent.shutdown()` может вернуть
-    // `success: true` — трекаем прерывание локально. REPL рвёт через
-    // `agent.shutdown()` (repl.ts `interruptRun`); повторяем.
-    let interrupted = false;
-    let toolCalls = 0;
-    const run = async (text) => {
-        interrupted = false;
-        toolCalls = 0;
-        state.agentRunning = true;
-        // Все события хода — за стартовавшей сессией, чтобы SSE лёг в правильную
-        // вкладку, даже если пользователь переключил табы.
-        state.activeSessionId = deps.sessionManager?.getActiveMeta()?.id;
-        try {
-            const result = await agent.run(text, (chunk) => forwarder.onText(chunk), (meta, kind) => forwarder.onMeta(meta, kind), (ev) => {
-                if (ev.type === "start") {
-                    forwarder.onToolStart(callFor(ev, startId(ev.tool)));
-                }
-                else {
-                    toolCalls++;
-                    forwarder.onToolEnd(callFor(ev, endId(ev.tool)), resultFor(ev), ev.duration ?? 0);
-                    // Закончивший `plan`/`todo`-тул освежает план-карточку ленты; сайдбар
-                    // живёт своей проекцией `/api/state`.
-                    const plan = planEventFor(ev.tool, deps.execModule);
-                    if (plan)
-                        forwarder.onPlan(plan);
-                }
-            }, (phase) => forwarder.onPhase(phase), (reasoning) => forwarder.onReasoning(reasoning));
-            // Usage забираем ДО `onTurnEnd`, чтобы бродкаст `state` сразу после хода
-            // уже нёс свежие метрики сайдбара (клиент и так поллит `/api/state`,
-            // так что это оптимизация, а не единственный путь).
-            state.usage = captureUsage(result, deps.contextWindow);
-            forwarder.onTurnEnd({
-                success: result.success,
-                durationMs: result.durationMs,
-                toolCalls,
-                interrupted: interrupted || undefined,
-            });
-            broadcast({ type: "state", ts: Date.now(), busy: state.busy, usage: state.usage }, state);
-            return result;
-        }
-        catch (err) {
-            forwarder.onTurnEnd({ success: false, interrupted: interrupted || undefined });
-            throw err;
-        }
-    };
-    const interrupt = () => {
-        interrupted = true;
-        // Разблокируем тулы, ждущие ответа браузера, до размотки хода.
-        cancelPendingQuestions(state);
-        agent.shutdown();
-    };
-    return { run, interrupt };
-}

package/dist/modules/webui/server.js

@@ -1,284 +0,0 @@
-// HTTP + SSE + REST транспорт `mma web` (app-слой отделён от listen ради тестов).
-/**
- * `handleRequest` — чистый app-слой на явном `WebUiState`, чтобы тесты гоняли
- * его герметично (правило #13: создание app отдельно от `listen()`).
- * `startServer`/`stopServer` по умолчанию — ленивое процесс-глобальное состояние
- * для CLI. Транспортные хелперы — в `./util`.
- */
-import { createServer } from "node:http";
-import { createWebUiState } from "./state";
-import { checkAuth, handleMessagePost, isLoopback, readBody, readBodyError, sameOrigin, sendJson, setAuthCookie, } from "./util";
-import { parseJsonBody } from "./body";
-import { handleConfigGet, handleConfigPost, handleModelsGet } from "./config-api";
-import { handleI18nGet } from "./i18n-api";
-import { webCommandList } from "./commands";
-import { handleAnswerPost } from "./answer-api";
-import { handleSessionsApi } from "./sessions-api";
-import { handleLspGet, handleMcpCreate, handleSettingsApi } from "./settings-api";
-import { handleProvidersApi } from "./providers-api";
-import { handleFileApi } from "./file-api";
-import { handleSetupApi } from "./setup-api";
-import { readEnv } from "../../config/env";
-/** Реэкспорт открытия браузера для CLI. */
-export { tryOpenBrowser } from "./util";
-/** Статические роуты, отдаваемые как есть (без шаблонной обработки). */
-const STATIC_ASSETS = {
-    "/index.html": { type: "text/html; charset=utf-8", key: "html" },
-    "/styles.css": { type: "text/css; charset=utf-8", key: "css" },
-    "/app.js": { type: "text/javascript; charset=utf-8", key: "js" },
-    "/setup.js": { type: "text/javascript; charset=utf-8", key: "setupJs" },
-    "/md.js": { type: "text/javascript; charset=utf-8", key: "mdJs" },
-    "/smd.js": { type: "text/javascript; charset=utf-8", key: "smdJs" },
-    "/hljs.js": { type: "text/javascript; charset=utf-8", key: "hljsJs" },
-};
-/**
- * SSE-хендлер: поток `/events` с капом клиентов и heartbeat.
- *
- * Backpressure: `res.write() === false` — буфер сокета полон (медленный/виснущий
- * читатель). Дропаем клиента сразу, а не копим события безгранично — живой вид
- * не стоит OOM.
- */
-function handleEvents(req, res, s) {
-    if (s.clients.size >= s.maxClients) {
-        sendJson(res, 503, { error: "too many clients" });
-        return;
-    }
-    res.writeHead(200, {
-        "Content-Type": "text/event-stream; charset=utf-8",
-        "Cache-Control": "no-cache",
-        Connection: "keep-alive",
-    });
-    const greeted = res.write("retry: 1200\n\n") &&
-        res.write(`event: state\ndata: ${JSON.stringify({ busy: s.busy })}\n\n`);
-    if (!greeted) {
-        res.end();
-        return;
-    }
-    s.clients.add(res);
-    const hb = setInterval(() => {
-        try {
-            if (!res.write(`: hb ${Date.now()}\n\n`))
-                dropClient(res, s);
-        }
-        catch {
-            dropClient(res, s); // клиент отвалился — heartbeat больше не нужен
-        }
-    }, 15_000);
-    const close = () => {
-        clearInterval(hb);
-        s.clients.delete(res);
-    };
-    req.on("close", close);
-    res.on("close", close);
-}
-/** Убирает медленного/битого SSE-клиента и закрывает его ответ. */
-function dropClient(res, s) {
-    s.clients.delete(res);
-    try {
-        res.end();
-    }
-    catch {
-        /* уже ушёл */
-    }
-}
-/** Точные роуты `METHOD путь` (правило #17: карта хендлеров, без `if`). */
-const API_ROUTES = {
-    "GET /api/state": (_req, res, s) => {
-        sendJson(res, 200, { busy: s.busy, state: s.bridge?.getState?.() ?? null });
-    },
-    "POST /api/message": (req, res, s) => handleMessagePost(req, res, s),
-    "GET /api/config": (_req, res, s) => handleConfigGet(res, s),
-    "POST /api/config": (req, res, s) => handleConfigPost(req, res, s),
-    "POST /api/answer": (req, res, s) => handleAnswerPost(req, res, s),
-    "GET /api/i18n": (_req, res, s) => handleI18nGet(res, s),
-    "GET /api/commands": (_req, res) => {
-        sendJson(res, 200, { commands: webCommandList() });
-    },
-    "GET /api/models": (_req, res, s) => handleModelsGet(res, s),
-    "POST /api/command": (req, res, s) => handleCommandPost(req, res, s),
-    "POST /api/interrupt": (_req, res, s) => handleInterruptPost(res, s),
-    "POST /api/mcp": (req, res, s) => handleMcpCreate(req, res, s),
-    "GET /api/lsp": (_req, res, s) => handleLspGet(res, s),
-};
-/**
- * Префикс-группы диспатча (sessions/settings/providers/file/setup владеют
- * своими под-путями). После точной таблицы; каждая сообщает, обработала ли.
- */
-const API_GROUPS = [handleSetupApi, handleSessionsApi, handleSettingsApi, handleProvidersApi, handleFileApi];
-/** REST-хендлер `/api/*`; auth + same-origin уже проверены. */
-function handleApi(req, res, reqUrl, s) {
-    const route = API_ROUTES[`${req.method} ${reqUrl.pathname}`];
-    if (route) {
-        route(req, res, s);
-        return;
-    }
-    for (const group of API_GROUPS) {
-        if (group(req, res, reqUrl, s))
-            return;
-    }
-    sendJson(res, 404, { error: "not found" });
-}
-/** `POST /api/command` — fire-and-forget диспатч, вывод стримится по SSE. */
-function handleCommandPost(req, res, s) {
-    if (s.setupRequired) {
-        sendJson(res, 409, { error: "setup_required" });
-        return;
-    }
-    const bridge = s.bridge;
-    readBody(req, s.maxBodyBytes)
-        .then((raw) => {
-        let line = "";
-        // Битое тело: диспатчер игнорирует не-слеш строку, так что это безвредный
-        // no-op, а не 400.
-        const rec = parseJsonBody(raw) ?? {};
-        if (typeof rec.line === "string")
-            line = rec.line;
-        // Ошибка хоста не должна стать 5xx: POST лишь подтверждает приём,
-        // вывод стримится по SSE событиями `command`.
-        Promise.resolve(bridge?.executeCommand(line)).catch(() => { });
-        sendJson(res, 202, { ok: true });
-    })
-        .catch((err) => {
-        readBodyError(req, res, err);
-    });
-}
-/** `POST /api/interrupt` — аборт бегущего хода без раннего разлока. */
-function handleInterruptPost(res, s) {
-    if (!s.busy && !s.bridge?.isBusy()) {
-        sendJson(res, 409, { error: "idle" });
-        return;
-    }
-    // `busy` здесь НЕ чистим: сбросом владеет форвардерный `onTurnEnd` для любого
-    // реально стартовавшего хода. Очистка сейчас разлочила бы UI, пока абортнутый
-    // ход ещё разматывается, и второй сабмит проскочил бы. Если хост реально не
-    // бежит (только резерв), `interrupt()` — no-op, и слот отпустит путь висящего сабмита.
-    s.bridge?.interrupt();
-    sendJson(res, 200, { ok: true });
-}
-/**
- * Точка входа запросов: SSE, статика, `/js`-модули, `/api/*`, иначе 404.
- * Auth обязателен и для SSE-потока, и для API; same-origin — для пишущих.
- */
-export function handleRequest(req, res, assets, s) {
-    let reqUrl;
-    try {
-        reqUrl = new URL(req.url || "/", `http://${req.headers.host || s.host}`);
-    }
-    catch {
-        // Битый/враждебный `Host` (или URL абсолютной формы): не роняем листенер —
-        // отвергаем запрос.
-        sendJson(res, 400, { error: "bad request" });
-        return;
-    }
-    if (reqUrl.pathname === "/events") {
-        // Auth и на SSE-поток: не-loopback бинд с токеном не должен светить события.
-        // `?token=` принимаем, т.к. EventSource заголовки ставить не умеет.
-        if (!checkAuth(req, reqUrl, s)) {
-            sendJson(res, 401, { error: "unauthorized" });
-            return;
-        }
-        setAuthCookie(res, s);
-        handleEvents(req, res, s);
-        return;
-    }
-    const asset = STATIC_ASSETS[reqUrl.pathname === "/" ? "/index.html" : reqUrl.pathname];
-    if (asset) {
-        // Перечитываем с диска, когда можно, чтобы правки ассетов цеплялись без
-        // рестарта; `no-store` не даёт браузеру кешировать протухший UI. Фиксированный
-        // снапшот из `startServer` — фолбэк (тесты, ошибки чтения).
-        const src = s.assetSource ? s.assetSource() : assets;
-        res.writeHead(200, { "Content-Type": asset.type, "Cache-Control": "no-store" });
-        res.end(src[asset.key] ?? assets[asset.key] ?? "");
-        return;
-    }
-    // Разделённые фронтенд-модули (`/js/*.js`, относительные ESM-импорты из `/app.js`).
-    // Та же live-reload семантика, что у статики выше.
-    if (reqUrl.pathname.startsWith("/js/") && reqUrl.pathname.endsWith(".js")) {
-        const key = reqUrl.pathname.slice(1);
-        const src = s.assetSource ? s.assetSource() : assets;
-        const body = src.jsModules?.[key] ?? assets.jsModules?.[key];
-        if (body !== undefined) {
-            res.writeHead(200, { "Content-Type": "text/javascript; charset=utf-8", "Cache-Control": "no-store" });
-            res.end(body);
-            return;
-        }
-    }
-    if (reqUrl.pathname.startsWith("/api/")) {
-        if (!checkAuth(req, reqUrl, s)) {
-            sendJson(res, 401, { error: "unauthorized" });
-            return;
-        }
-        if (!sameOrigin(req, reqUrl)) {
-            sendJson(res, 403, { error: "cross-origin requests are not allowed" });
-            return;
-        }
-        setAuthCookie(res, s);
-        handleApi(req, res, reqUrl, s);
-        return;
-    }
-    res.writeHead(404, { "Content-Type": "text/plain" });
-    res.end("Not found");
-}
-let defaultState = null;
-/** Ленивое процесс-глобальное состояние для вызовов без явного. */
-function getDefaultState() {
-    if (!defaultState)
-        defaultState = createWebUiState();
-    return defaultState;
-}
-/**
- * Стартует HTTP-сервер на хосте/порту состояния (порт — env `MMA_WEBUI_PORT`).
- * Не-loopback без токена — отказ. Резолвится публичным URL.
- */
-export function startServer(assets, s = getDefaultState()) {
-    if (s.server)
-        return Promise.resolve(s.url);
-    if (s.starting)
-        return s.starting;
-    if (!isLoopback(s.host) && !s.token) {
-        return Promise.reject(new Error(`refusing to bind ${s.host} without a token (non-loopback)`));
-    }
-    const desired = Number(readEnv("WEBUI_PORT")) || 0;
-    s.starting = new Promise((resolve, reject) => {
-        const srv = createServer((req, res) => handleRequest(req, res, assets, s));
-        srv.on("error", (err) => {
-            s.starting = null;
-            reject(err);
-        });
-        srv.listen(desired, s.host, () => {
-            s.server = srv;
-            const addr = srv.address();
-            const port = typeof addr === "object" && addr ? addr.port : desired;
-            s.url = `http://${s.host}:${port}`;
-            s.starting = null;
-            resolve(s.url);
-        });
-    });
-    return s.starting;
-}
-/** Останавливает сервер: дроп клиентов, закрытие, сброс busy-флагов. */
-export function stopServer(s = getDefaultState()) {
-    for (const client of s.clients) {
-        try {
-            client.end();
-        }
-        catch {
-            /* best-effort чистка */
-        }
-    }
-    s.clients.clear();
-    if (s.server) {
-        try {
-            s.server.close();
-        }
-        catch {
-            /* best-effort чистка */
-        }
-        s.server = null;
-    }
-    s.starting = null;
-    s.busy = false;
-    s.agentRunning = false;
-    s.turnToken = null;
-    s.lastPostTs = 0;
-}

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

@@ -1,178 +0,0 @@
-import { handleSessionHistory } from "./history-api";
-import { readBody, readBodyError, sendJson } from "./util";
-import { parseJsonBody, readJsonBody } from "./body";
-/** `GET /api/sessions` — список сессий (id/имя/обновление/модель/счёт). */
-export function handleSessionsGet(res, s) {
-    if (!s.sessionManager) {
-        sendJson(res, 503, { error: "sessions_unavailable" });
-        return;
-    }
-    const sessions = s.sessionManager.list().map((meta) => ({
-        id: meta.id,
-        name: meta.name,
-        updatedAt: meta.updatedAt,
-        model: meta.model,
-        messageCount: meta.messageCount,
-    }));
-    sendJson(res, 200, { sessions });
-}
-/**
- * `POST /api/sessions {name?}` — новая сессия.
- *
- * Настоящий `SessionManager.create` заодно делает её активной, чтобы UI открыл
- * вкладку и SSE наполнил ленту. Менеджер без `create` (или без менеджера) —
- * пробел сервера: отвечаем 503.
- */
-export function handleSessionCreate(req, res, s) {
-    const manager = s.sessionManager;
-    if (!manager || typeof manager.create !== "function") {
-        sendJson(res, 503, { error: "sessions_unavailable" });
-        return;
-    }
-    const create = manager.create.bind(manager);
-    readBody(req, s.maxBodyBytes)
-        .then((raw) => {
-        let name;
-        if (raw.trim()) {
-            const rec = parseJsonBody(raw);
-            if (!rec) {
-                sendJson(res, 400, { error: "invalid JSON" });
-                return;
-            }
-            if (typeof rec.name === "string" && rec.name.trim())
-                name = rec.name.trim();
-        }
-        try {
-            const meta = create(name);
-            // План следует за сессией: новая — без плана, трекер сбрасывается.
-            try {
-                s.execModule?.switchSession(meta.id);
-            }
-            catch {
-                // fail-open: сессия создана, план остался как был
-            }
-            sendJson(res, 201, {
-                ok: true,
-                session: {
-                    id: meta.id,
-                    name: meta.name,
-                    createdAt: meta.createdAt,
-                    updatedAt: meta.updatedAt,
-                    messageCount: meta.messageCount,
-                    model: meta.model,
-                },
-            });
-        }
-        catch {
-            sendJson(res, 500, { error: "create_failed" });
-        }
-    })
-        .catch((err) => {
-        readBodyError(req, res, err);
-    });
-}
-/** `POST /api/sessions/activate {id}` — переключить активную сессию. */
-export function handleSessionActivate(req, res, s) {
-    if (!s.sessionManager) {
-        sendJson(res, 503, { error: "sessions_unavailable" });
-        return;
-    }
-    const manager = s.sessionManager;
-    readJsonBody(req, s.maxBodyBytes)
-        .then((rec) => {
-        if (!rec) {
-            sendJson(res, 400, { error: "invalid JSON" });
-            return;
-        }
-        const id = typeof rec.id === "string" ? rec.id : "";
-        if (!id) {
-            sendJson(res, 400, { error: "missing id" });
-            return;
-        }
-        try {
-            manager.setActive(id);
-        }
-        catch {
-            sendJson(res, 404, { error: "not_found" });
-            return;
-        }
-        // План следует за сессией: трекер переключается на план этой сессии
-        // (или пустеет). Сайдбар следующего `/api/state` уже покажет его.
-        try {
-            s.execModule?.switchSession(id);
-        }
-        catch {
-            // fail-open: сессия переключена, план остался как был
-        }
-        sendJson(res, 200, { ok: true });
-    })
-        .catch((err) => {
-        readBodyError(req, res, err);
-    });
-}
-/**
- * `DELETE /api/sessions/:id` — удалить сессию.
- *
- * Гард: АКТИВНУЮ удалять нельзя (409 `active_session`) — иначе агент останется
- * указывать на исчезнувший файл посреди хода; UI сначала переключается.
- * Чужие id — 404.
- */
-export function handleSessionDelete(res, id, s) {
-    if (!s.sessionManager) {
-        sendJson(res, 503, { error: "sessions_unavailable" });
-        return;
-    }
-    if (!id || !s.sessionManager.get(id)) {
-        sendJson(res, 404, { error: "not_found" });
-        return;
-    }
-    if (s.sessionManager.getActive() === id) {
-        sendJson(res, 409, { error: "active_session" });
-        return;
-    }
-    try {
-        s.sessionManager.delete(id);
-    }
-    catch {
-        sendJson(res, 404, { error: "not_found" });
-        return;
-    }
-    // План следует за сессией: слот удалённой сессии не оставляем мусором.
-    try {
-        s.execModule?.forgetSession(id);
-    }
-    catch {
-        /* best-effort */
-    }
-    sendJson(res, 200, { ok: true });
-}
-/**
- * Диспатч роутов `/api/sessions*`. Возвращает, обработан ли запрос, чтобы
- * `server.ts` держал плоскую цепочку без дубля парсинга путей.
- */
-export function handleSessionsApi(req, res, reqUrl, s) {
-    const p = reqUrl.pathname;
-    if (p === "/api/sessions" && req.method === "GET") {
-        handleSessionsGet(res, s);
-        return true;
-    }
-    if (p === "/api/sessions" && req.method === "POST") {
-        handleSessionCreate(req, res, s);
-        return true;
-    }
-    if (p === "/api/sessions/activate" && req.method === "POST") {
-        handleSessionActivate(req, res, s);
-        return true;
-    }
-    if (p.startsWith("/api/sessions/") && p.endsWith("/history") && req.method === "GET") {
-        const id = decodeURIComponent(p.slice("/api/sessions/".length, -"/history".length));
-        handleSessionHistory(res, id, s);
-        return true;
-    }
-    if (p.startsWith("/api/sessions/") && req.method === "DELETE") {
-        const id = decodeURIComponent(p.slice("/api/sessions/".length));
-        handleSessionDelete(res, id, s);
-        return true;
-    }
-    return false;
-}