micro-models-agent 2.16.0 → 2.17.1

package/dist/modules/browser/actions.js

@@ -1,79 +0,0 @@
-// JS-сниппеты для действий в странице: клик, ввод, скролл, разметка, извлечение текста.
-/** JS для клика по элементу с индексом из снапшота. */
-export function buildClickScript(elementIndex) {
-    return `
-    const el = document.querySelector('[data-browser-index="${elementIndex}"]');
-    if (!el) throw new Error('Element not found: ${elementIndex}');
-    el.click();
-  `;
-}
-/** JS для ввода текста в поле: фокус, установка значения, события input/change. */
-export function buildTypeScript(elementIndex, text) {
-    const escaped = JSON.stringify(text);
-    return `
-    const el = document.querySelector('[data-browser-index="${elementIndex}"]');
-    if (!el) throw new Error('Element not found: ${elementIndex}');
-    const text = JSON.parse(${JSON.stringify(escaped)});
-    el.focus();
-    el.value = text;
-    el.dispatchEvent(new Event('input', { bubbles: true }));
-    el.dispatchEvent(new Event('change', { bubbles: true }));
-  `;
-}
-/** JS для прокрутки страницы в заданном направлении. */
-export function buildScrollScript(direction) {
-    switch (direction) {
-        case "down":
-            return `window.scrollBy({ top: 600, behavior: 'smooth' })`;
-        case "up":
-            return `window.scrollBy({ top: -600, behavior: 'smooth' })`;
-        case "top":
-            return `window.scrollTo({ top: 0, behavior: 'smooth' })`;
-        case "bottom":
-            return `window.scrollTo({ top: document.body.scrollHeight, behavior: 'smooth' })`;
-    }
-}
-/** JS для простановки интерактивным элементам атрибутов data-browser-index. */
-export function buildIndexInjectionScript() {
-    return `
-    const selectors = 'a[href], button, input, textarea, select, [role="button"], [role="link"], [role="textbox"], [role="checkbox"], [role="radio"], [contenteditable="true"]';
-    const elements = document.querySelectorAll(selectors);
-    let idx = 1;
-    elements.forEach(el => {
-      const style = window.getComputedStyle(el);
-      if (style.display === 'none' || style.visibility === 'hidden') return;
-      el.setAttribute('data-browser-index', String(idx++));
-    });
-  `;
-}
-/** JS для извлечения видимого текстового содержимого страницы построчно. */
-export function buildTextExtractionScript() {
-    return `
-    const contentTags = new Set(['h1','h2','h3','h4','h5','h6','p','li','article','main','section','blockquote','pre','td','th','dt','dd','figcaption']);
-    const out = [];
-    const seen = new Set();
-    const isHidden = (el) => {
-      const st = window.getComputedStyle(el);
-      return st.display === 'none' || st.visibility === 'hidden';
-    };
-    const walker = document.createTreeWalker(document.body, NodeFilter.SHOW_ELEMENT, {
-      acceptNode: (node) => {
-        const tag = node.tagName ? node.tagName.toLowerCase() : '';
-        if (!contentTags.has(tag)) return NodeFilter.FILTER_SKIP;
-        if (isHidden(node)) return NodeFilter.FILTER_REJECT;
-        return NodeFilter.FILTER_ACCEPT;
-      }
-    });
-    let node;
-    while ((node = walker.nextNode())) {
-      const tag = node.tagName.toLowerCase();
-      const text = (node.textContent || '').replace(/\\s+/g, ' ').trim();
-      if (!text) continue;
-      if (seen.has(text)) continue;
-      seen.add(text);
-      const line = text.length > 200 ? text.slice(0, 200) + '…' : text;
-      out.push('[' + tag + '] ' + line);
-    }
-    return out.join('\\n');
-  `;
-}

package/dist/modules/browser/bridge-client.js

@@ -1,203 +0,0 @@
-// Драйвер через node-мост (дочерний процесс bridge-server.mjs по JSON-RPC поверх stdio).
-import { spawn } from "child_process";
-import { createInterface } from "readline";
-import { dirname, join } from "path";
-import { fileURLToPath } from "url";
-import { ConsoleBuffer } from "./console-buffer";
-import { pickExistingPath } from "./bridge-path";
-import { BROWSER_BRIDGE_REQUEST_TIMEOUT_MS as BRIDGE_REQUEST_TIMEOUT_MS } from "../../config/timeouts";
-function bridgeScriptPath() {
-    // Резолв скрипта моста для ОБЕИХ раскладок (пути читаются с диска):
-    //   src/modules/browser/bridge-server.mjs          (bun run src/…)
-    //   dist/modules/browser/bridge-server.mjs         (бандл dist/main.js +
-    //                                                   ассеты от copy-assets.ts)
-    // Версия с одним кандидатом искала рядом с бандлом (dist/bridge-server.mjs),
-    // чего copy-assets.ts не создаёт, — и тул браузера падал с ENOENT
-    // в опубликованном npm-пакете (наблюдалось: v0.37.0).
-    const dir = dirname(fileURLToPath(import.meta.url));
-    const candidates = [
-        join(dir, "bridge-server.mjs"),
-        join(dir, "modules", "browser", "bridge-server.mjs"),
-    ];
-    return pickExistingPath(candidates);
-}
-/** Драйвер поверх node-моста: команды шлются JSON-строками в stdin дочернего процесса. */
-export class BridgeDriver {
-    proc = null;
-    rl = null;
-    pending = new Map();
-    lastStderr = [];
-    nextId = 1;
-    lastUrl = "";
-    console = new ConsoleBuffer(500);
-    network = [];
-    maxConsoleLineChars;
-    constructor(opts = {}) {
-        this.maxConsoleLineChars = opts.maxConsoleLineChars ?? 400;
-    }
-    async send(cmd, params = {}, retried = false) {
-        if (!this.proc || !this.rl) {
-            if (retried || cmd === "close")
-                throw new Error("Bridge is not running");
-            this.spawnBridge();
-            return this.send(cmd, params, true);
-        }
-        const id = this.nextId++;
-        const response = await new Promise((resolve, reject) => {
-            const timer = setTimeout(() => {
-                this.pending.delete(id);
-                reject(new Error(`Bridge timeout waiting for "${cmd}"`));
-            }, BRIDGE_REQUEST_TIMEOUT_MS);
-            this.pending.set(id, (resp) => {
-                clearTimeout(timer);
-                resolve(resp);
-            });
-            this.proc.stdin.write(`${JSON.stringify({ id, cmd, params })}\n`);
-        });
-        this.drainEvents(response);
-        if (!response.ok)
-            throw new Error(response.error || `Bridge command failed: ${cmd}`);
-        return response;
-    }
-    drainEvents(resp) {
-        if (Array.isArray(resp.console)) {
-            for (const entry of resp.console) {
-                this.console.add(entry.type, entry.text);
-            }
-        }
-        if (Array.isArray(resp.network)) {
-            for (const err of resp.network)
-                this.network.push(err);
-        }
-        if (resp.data && typeof resp.data.url === "string") {
-            this.lastUrl = resp.data.url;
-        }
-    }
-    async launch(cfg) {
-        this.spawnBridge();
-        await this.send("launch", {
-            headless: cfg.headless,
-            viewport: cfg.viewport,
-            timeoutMs: cfg.timeoutMs,
-            executablePath: cfg.overrides?.executablePath,
-            channel: cfg.overrides?.channel,
-            maxConsoleLineChars: this.maxConsoleLineChars,
-        });
-    }
-    spawnBridge() {
-        const script = bridgeScriptPath();
-        const proc = spawn("node", [script], { stdio: ["pipe", "pipe", "pipe"], windowsHide: true });
-        this.proc = proc;
-        this.lastStderr = [];
-        proc.stderr.on("data", (chunk) => {
-            this.lastStderr = [...this.lastStderr.slice(-4), chunk.toString()];
-        });
-        const rl = createInterface({ input: proc.stdout });
-        this.rl = rl;
-        rl.on("line", (line) => {
-            let resp;
-            try {
-                resp = JSON.parse(line);
-            }
-            catch {
-                return;
-            }
-            const resolver = this.pending.get(resp.id);
-            if (resolver) {
-                this.pending.delete(resp.id);
-                resolver(resp);
-            }
-        });
-        proc.on("error", (err) => {
-            if (this.proc !== proc)
-                return; // протухший потомок — жив уже новый мост
-            this.failPending(`Bridge process failed to start: ${err.message}`);
-            this.proc = null;
-            this.rl = null;
-        });
-        proc.on("exit", (code) => {
-            if (this.proc !== proc)
-                return; // протухший потомок — жив уже новый мост
-            const stderrTail = this.lastStderr.join("").trim();
-            this.failPending(stderrTail
-                ? `Bridge process exited (code ${code}): ${stderrTail.slice(0, 300)}`
-                : `Bridge process exited (code ${code})`);
-            this.proc = null;
-            this.rl = null;
-        });
-    }
-    failPending(error) {
-        for (const [, resolver] of this.pending) {
-            resolver({ id: -1, ok: false, error });
-        }
-        this.pending.clear();
-    }
-    async goto(url, timeoutMs) {
-        await this.send("goto", { url, timeoutMs });
-    }
-    async evaluate(js) {
-        const resp = await this.send("evaluate", { js });
-        return resp.data?.result;
-    }
-    async content() {
-        const resp = await this.send("content");
-        return String(resp.data?.html ?? "");
-    }
-    async title() {
-        const resp = await this.send("title");
-        return String(resp.data?.title ?? "");
-    }
-    url() {
-        return this.lastUrl;
-    }
-    async waitForLoad(timeoutMs) {
-        await this.send("waitLoad", { timeoutMs });
-    }
-    async screenshot() {
-        const resp = await this.send("screenshot");
-        return Buffer.from(String(resp.data?.base64 ?? ""), "base64");
-    }
-    async cookies() {
-        const resp = await this.send("cookies");
-        return (resp.data?.cookies ?? []);
-    }
-    async addCookies(cookies) {
-        await this.send("setCookies", { cookies });
-    }
-    async goBack(timeoutMs) {
-        await this.send("back", { timeoutMs });
-    }
-    async goForward(timeoutMs) {
-        await this.send("forward", { timeoutMs });
-    }
-    resetEventLog() {
-        this.console.clear();
-        this.network = [];
-    }
-    getConsole() {
-        return this.console.getAll();
-    }
-    getNetworkErrors() {
-        return this.network.slice(-15);
-    }
-    async close() {
-        try {
-            if (this.proc)
-                await this.send("close");
-        }
-        catch {
-            // игнорируем — идёт завершение работы
-        }
-        this.dispose();
-    }
-    dispose() {
-        if (this.proc) {
-            this.proc.kill();
-            this.proc = null;
-        }
-        if (this.rl) {
-            this.rl.close();
-            this.rl = null;
-        }
-    }
-}

package/dist/modules/browser/bridge-path.js

@@ -1,10 +0,0 @@
-// Поиск скрипта node-моста: раскладки src/ и dist/ (тестируемо без запуска моста).
-import { existsSync } from "fs";
-/**
- * Первый существующий путь из кандидатов, иначе — первый кандидат.
- * Вынесено из bridge-client.ts, чтобы резолв раскладки src-vs-dist
- * тестировался без спавна node-моста (пути читаются с диска в рантайме, не инлайнятся).
- */
-export function pickExistingPath(candidates, fallback = candidates[0]) {
-    return candidates.find((p) => existsSync(p)) ?? fallback;
-}

package/dist/modules/browser/console-buffer.js

@@ -1,37 +0,0 @@
-const CONSOLE_MAX_LINE = 400;
-/**
- * Ограниченный буфер записей консоли браузера.
- * Вынесен из `session.ts`, чтобы `driver.ts` и `bridge-client.ts` делили его
- * БЕЗ импорта `session.ts` — это ребро давало два цикла импортов
- * (`driver ↔ session`, `driver → bridge-client → session`).
- */
-export class ConsoleBuffer {
-    entries = [];
-    maxEntries;
-    constructor(maxEntries = 20) {
-        this.maxEntries = maxEntries;
-    }
-    /** Добавить запись; пустые отбрасываются, длинные строки режутся. */
-    add(type, text) {
-        const clean = String(text).replace(/\s+/g, " ").trim();
-        if (!clean)
-            return;
-        const line = clean.length > CONSOLE_MAX_LINE ? `${clean.slice(0, CONSOLE_MAX_LINE)}…` : clean;
-        this.entries.push({ type, text: line });
-        if (this.entries.length > this.maxEntries) {
-            this.entries.splice(0, this.entries.length - this.maxEntries);
-        }
-    }
-    /** Очистить буфер. */
-    clear() {
-        this.entries = [];
-    }
-    /** Все записи копией. */
-    getAll() {
-        return [...this.entries];
-    }
-    /** Текущее число записей. */
-    get size() {
-        return this.entries.length;
-    }
-}

package/dist/modules/browser/cookie-store.js

@@ -1,29 +0,0 @@
-// Персистентное хранилище cookies браузера (cookies.json в cookieDir).
-import { readFile, writeFile, mkdir } from "fs/promises";
-import { join } from "path";
-/** Файловое хранилище кук (cookies.json). */
-export class CookieStore {
-    filePath;
-    constructor(cookieDir) {
-        this.filePath = join(cookieDir, "cookies.json");
-    }
-    /** Сохранить куки в файл. */
-    async save(cookies) {
-        await mkdir(join(this.filePath, ".."), { recursive: true });
-        await writeFile(this.filePath, JSON.stringify(cookies, null, 2), "utf-8");
-    }
-    /** Загрузить куки; при отсутствии/битом файле — пустой список. */
-    async load() {
-        try {
-            const data = await readFile(this.filePath, "utf-8");
-            return JSON.parse(data);
-        }
-        catch {
-            return [];
-        }
-    }
-    /** Удалить все куки. */
-    async clear() {
-        await this.save([]);
-    }
-}

package/dist/modules/browser/driver-types.js

@@ -1 +0,0 @@
-export {};

package/dist/modules/browser/driver.js

@@ -1,186 +0,0 @@
-// Playwright-драйвер: запуск Chromium, навигация, снапшоты, выбор транспорта.
-import { chromium } from "playwright";
-import { ConsoleBuffer } from "./console-buffer";
-import { MMA_ENV } from "../../config/env";
-import { BROWSER_DIRECT_LAUNCH_TIMEOUT_MS as CANONICAL_DIRECT_LAUNCH_TIMEOUT_MS } from "../../config/timeouts";
-/** Таймаут прямого запуска Playwright до отката на node-мост. */
-/** Публичный экспорт-алиас: то же значение из реестра. */
-export const DIRECT_LAUNCH_TIMEOUT_MS = CANONICAL_DIRECT_LAUNCH_TIMEOUT_MS;
-/** Оверрайды запуска из env (MMA_BROWSER_EXECUTABLE/MMA_BROWSER_CHANNEL). */
-export function resolveBrowserLaunchOverrides(env = process.env) {
-    const executablePath = env[MMA_ENV.BROWSER_EXECUTABLE]?.trim();
-    const channel = env[MMA_ENV.BROWSER_CHANNEL]?.trim();
-    const out = {};
-    if (executablePath)
-        out.executablePath = executablePath;
-    if (channel)
-        out.channel = channel;
-    return out;
-}
-/** Системные браузеры, если bundled-ревизия Chromium отсутствует. */
-const SYSTEM_CHANNEL_FALLBACKS = ["chrome", "msedge"];
-function isMissingBrowserError(err) {
-    return /Executable doesn't exist|is not found|looks like Playwright was just installed/i.test(String(err?.message ?? err));
-}
-/**
- * Запуск Chromium с фолбэком на системный Chrome/Edge, если bundled-ревизии
- * нет (CDN недоступен). Явный оверрайд всегда побеждает и подавляет фолбэк —
- * выбор пользователя должен падать громко.
- */
-export async function launchChromiumWithFallback(launch, cfg, overrides = {}) {
-    const base = { headless: cfg.headless, timeout: cfg.timeoutMs, ...overrides };
-    try {
-        return await launch(base);
-    }
-    catch (err) {
-        const explicit = overrides.executablePath || overrides.channel;
-        if (explicit || !isMissingBrowserError(err))
-            throw err;
-        let lastErr = err;
-        for (const channel of SYSTEM_CHANNEL_FALLBACKS) {
-            try {
-                return await launch({ ...base, channel });
-            }
-            catch (e) {
-                lastErr = e;
-            }
-        }
-        throw lastErr;
-    }
-}
-function launchChromium(cfg, overrides) {
-    return launchChromiumWithFallback((opts) => chromium.launch(opts), cfg, overrides);
-}
-/** Драйвер поверх Playwright: страница, консоль, сетевые ошибки. */
-export class PlaywrightDriver {
-    browser = null;
-    context = null;
-    page = null;
-    console = new ConsoleBuffer();
-    network = [];
-    async launch(cfg) {
-        if (this.browser)
-            return;
-        this.browser = await launchChromium(cfg, cfg.overrides ?? {});
-        this.context = await this.browser.newContext({ viewport: cfg.viewport });
-        this.page = await this.context.newPage();
-        this.page.setDefaultTimeout(cfg.timeoutMs);
-        this.page.on("console", (msg) => this.console.add(msg.type(), msg.text()));
-        this.page.on("pageerror", (err) => this.console.add("pageerror", `Page error: ${err.message}`));
-        this.page.on("requestfailed", (req) => {
-            const failure = req.failure();
-            this.network.push({
-                method: req.method(),
-                url: req.url(),
-                error: failure?.errorText || "unknown",
-            });
-        });
-    }
-    async goto(url, timeoutMs) {
-        this.requirePage();
-        this.console.clear();
-        this.network = [];
-        await this.page.goto(url, { waitUntil: "domcontentloaded", timeout: timeoutMs });
-    }
-    async evaluate(js) {
-        return this.requirePage().evaluate(js);
-    }
-    async content() {
-        return this.requirePage().content();
-    }
-    async title() {
-        return this.requirePage().title();
-    }
-    url() {
-        return this.page?.url() || "";
-    }
-    async waitForLoad(timeoutMs) {
-        await this.requirePage()
-            .waitForLoadState("domcontentloaded", { timeout: timeoutMs })
-            .catch(() => { });
-    }
-    async screenshot() {
-        return this.requirePage().screenshot({ type: "png", fullPage: false });
-    }
-    async cookies() {
-        if (!this.context)
-            return [];
-        return this.context.cookies();
-    }
-    async addCookies(cookies) {
-        if (!this.context || cookies.length === 0)
-            return;
-        await this.context.addCookies(cookies);
-    }
-    async goBack(timeoutMs) {
-        await this.requirePage()
-            .goBack({ waitUntil: "domcontentloaded", timeout: timeoutMs })
-            .catch(() => { });
-    }
-    async goForward(timeoutMs) {
-        await this.requirePage()
-            .goForward({ waitUntil: "domcontentloaded", timeout: timeoutMs })
-            .catch(() => { });
-    }
-    resetEventLog() {
-        this.console.clear();
-        this.network = [];
-    }
-    getConsole() {
-        return this.console.getAll();
-    }
-    getNetworkErrors() {
-        return this.network.slice(-15);
-    }
-    async close() {
-        if (this.page)
-            await this.page.close().catch(() => { });
-        if (this.context)
-            await this.context.close().catch(() => { });
-        if (this.browser)
-            await this.browser.close().catch(() => { });
-        this.page = null;
-        this.context = null;
-        this.browser = null;
-    }
-    dispose() {
-        this.close().catch(() => { });
-    }
-    requirePage() {
-        if (!this.page)
-            throw new Error("No page open");
-        return this.page;
-    }
-}
-/** Создать драйвер: прямой Playwright, при неудаче — node-мост. */
-export function createBrowserDriver(config) {
-    const common = {
-        headless: config.headless,
-        viewport: { width: config.viewportWidth, height: config.viewportHeight },
-        timeoutMs: config.navigationTimeout,
-        overrides: resolveBrowserLaunchOverrides(),
-    };
-    return (async () => {
-        // Транспорт pipe/websocket у Playwright сломан под Bun на части платформ
-        // (см. oven-sh/bun#31105, #9911). Под Bun всегда идём через node-мост,
-        // под Node сначала пробуем прямой путь.
-        if (process.versions.bun) {
-            return launchBridge(config, common);
-        }
-        const direct = new PlaywrightDriver();
-        try {
-            await direct.launch({ ...common, timeoutMs: DIRECT_LAUNCH_TIMEOUT_MS });
-            return direct;
-        }
-        catch {
-            direct.dispose();
-        }
-        return launchBridge(config, common);
-    })();
-}
-async function launchBridge(config, common) {
-    const { BridgeDriver } = await import("./bridge-client");
-    const bridge = new BridgeDriver({ maxConsoleLineChars: config.maxConsoleLineChars });
-    await bridge.launch(common);
-    return bridge;
-}

package/dist/modules/browser/index.js

@@ -1,9 +0,0 @@
-// Публичный фасад модуля браузера: сессия, драйверы, снапшоты, типы.
-export { BrowserModule } from "./module";
-export { BrowserSession, BrowserActionTracker } from "./session";
-export { ConsoleBuffer } from "./console-buffer";
-export { CookieStore } from "./cookie-store";
-export { createBrowserDriver, PlaywrightDriver } from "./driver";
-export { BridgeDriver } from "./bridge-client";
-export { extractInteractiveElements, formatSnapshot, truncateText } from "./snapshot";
-export { DEFAULT_BROWSER_CONFIG } from "./types";

package/dist/modules/browser/module.js

@@ -1,30 +0,0 @@
-import { createBrowserTool, closeBrowserSession } from "../../tools/browser";
-/** Модуль headless-браузера: промпт workflow, тул, плагин закрытия сессии. */
-export class BrowserModule {
-    name = "browser";
-    getSystemPromptBlock() {
-        return {
-            content: [
-                "You have a headless browser tool. Use it to navigate websites, click links, fill forms, and read page content.",
-                "Workflow: open(url) → read snapshot → click/type on element numbers → read updated snapshot.",
-                'Each snapshot includes a "Content" section with the visible page text, a "Console" section with browser messages, and network errors. Use these to understand the page, detect JS errors, and verify the result of your actions.',
-                'Always start with "open" action. Use element numbers from snapshot for click/type targets.',
-                'The "screenshot" action is delivered automatically: a vision model receives the image, a text-only model receives the text snapshot instead. You do not need to decide — just call it and read what you get.',
-            ].join("\n"),
-            priority: "normal",
-            essential: false,
-            estimatedTokens: 80,
-        };
-    }
-    getToolDefinitions() {
-        return [createBrowserTool()];
-    }
-    getPlugin() {
-        return {
-            name: "browser",
-            onSessionEnd: () => {
-                closeBrowserSession();
-            },
-        };
-    }
-}