micro-models-agent 0.41.0 → 0.41.2

package/dist/modules/browser/session.js

@@ -1,8 +1,35 @@
-import { chromium, } from "playwright";
+import { createBrowserDriver } from "./driver";
 import { extractInteractiveElements, formatSnapshot } from "./snapshot";
-import { buildClickScript, buildTypeScript, buildScrollScript, buildIndexInjectionScript, } from "./actions";
+import { buildClickScript, buildTypeScript, buildScrollScript, buildIndexInjectionScript, buildTextExtractionScript, } from "./actions";
 import { CookieStore } from "./cookie-store";
 import { t } from "../../i18n/index";
+const CONSOLE_MAX_LINE = 400;
+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;
+    }
+}
 export class BrowserActionTracker {
     history = [];
     threshold;
@@ -30,9 +57,7 @@ export class BrowserActionTracker {
     }
 }
 export class BrowserSession {
-    browser = null;
-    context = null;
-    page = null;
+    driver = null;
     config;
     cookieStore;
     state = {
@@ -90,7 +115,7 @@ export class BrowserSession {
                     };
             }
             if (action !== "open") {
-                const warning = this.actionTracker.record(action, args, this.page?.url() || "");
+                const warning = this.actionTracker.record(action, args, this.driver?.url() || "");
                 if (warning && result.success) {
                     result.output = result.output + "\n\n⚠️ " + warning;
                 }
@@ -104,45 +129,41 @@ export class BrowserSession {
             };
         }
     }
-    async ensurePage() {
-        if (!this.page) {
+    async ensureDriver() {
+        if (!this.driver) {
             return { success: false, output: t("browser.no_page") };
         }
         return null;
     }
     async launch() {
-        if (this.browser)
+        if (this.driver)
             return;
-        this.browser = await chromium.launch({ headless: this.config.headless });
-        this.context = await this.browser.newContext({
-            viewport: {
-                width: this.config.viewportWidth,
-                height: this.config.viewportHeight,
-            },
-        });
+        this.driver = await createBrowserDriver(this.config);
         const savedCookies = await this.cookieStore.load();
         if (savedCookies.length > 0) {
-            await this.context.addCookies(savedCookies.map((c) => ({
-                ...c,
-                sameSite: c.sameSite,
-            })));
+            await this.driver.addCookies(savedCookies);
         }
-        this.page = await this.context.newPage();
-        this.page.setDefaultTimeout(this.config.navigationTimeout);
     }
     async saveCookies() {
-        if (!this.context)
+        if (!this.driver)
             return;
-        const cookies = await this.context.cookies();
+        const cookies = await this.driver.cookies();
         await this.cookieStore.save(cookies);
     }
     async takeSnapshot() {
-        if (!this.page)
+        if (!this.driver)
             return "No page open.";
-        await this.page.evaluate(buildIndexInjectionScript());
-        const html = await this.page.content();
-        const url = this.page.url();
-        const title = await this.page.title();
+        await this.driver.evaluate(buildIndexInjectionScript());
+        const html = await this.driver.content();
+        const url = this.driver.url();
+        const title = await this.driver.title();
+        let content = "";
+        try {
+            content = String(await this.driver.evaluate(buildTextExtractionScript()));
+        }
+        catch {
+            content = "";
+        }
         const allElements = extractInteractiveElements(html, this.config.maxElements + 5);
         const truncated = allElements.length > this.config.maxElements;
         const elements = allElements.slice(0, this.config.maxElements);
@@ -152,26 +173,30 @@ export class BrowserSession {
             title,
             elementCount: elements.length,
         };
-        return formatSnapshot({ url, title, elements, truncated });
+        return formatSnapshot({
+            url,
+            title,
+            elements,
+            content,
+            console: this.driver.getConsole(),
+            networkErrors: this.driver.getNetworkErrors(),
+            truncated,
+        });
     }
     async open(url) {
         if (!url)
             return { success: false, output: t("browser.url_required") };
-        if (!url.startsWith("http://") &&
-            !url.startsWith("https://") &&
-            !url.startsWith("file://")) {
+        if (!url.startsWith("http://") && !url.startsWith("https://") && !url.startsWith("file://")) {
             const isLocalhost = /^(localhost|127\.0\.0\.1|0\.0\.0\.0)(:\d+)?$/i.test(url);
             url = isLocalhost ? "http://" + url : "https://" + url;
         }
         await this.launch();
-        if (!this.page)
+        if (!this.driver)
             return { success: false, output: t("browser.create_page_failed") };
         this.actionTracker.reset();
+        this.driver.resetEventLog();
         try {
-            await this.page.goto(url, {
-                waitUntil: "domcontentloaded",
-                timeout: this.config.navigationTimeout,
-            });
+            await this.driver.goto(url, this.config.navigationTimeout);
         }
         catch (err) {
             return {
@@ -184,20 +209,17 @@ export class BrowserSession {
         return { success: true, output: snapshot };
     }
     async click(target) {
-        const err = await this.ensurePage();
+        const err = await this.ensureDriver();
         if (err)
             return err;
-        if (!this.page)
+        if (!this.driver)
             return { success: false, output: "No page" };
         if (!target || target < 1) {
             return { success: false, output: t("browser.invalid_target") };
         }
         try {
-            const script = buildClickScript(target);
-            await this.page.evaluate(script);
-            await this.page
-                .waitForLoadState("domcontentloaded", { timeout: 5000 })
-                .catch(() => { });
+            await this.driver.evaluate(buildClickScript(target));
+            await this.driver.waitForLoad(5000);
             await new Promise((r) => setTimeout(r, 500));
             const snapshot = await this.takeSnapshot();
             await this.saveCookies();
@@ -211,10 +233,10 @@ export class BrowserSession {
         }
     }
     async type(target, text) {
-        const err = await this.ensurePage();
+        const err = await this.ensureDriver();
         if (err)
             return err;
-        if (!this.page)
+        if (!this.driver)
             return { success: false, output: "No page" };
         if (!target || target < 1) {
             return { success: false, output: t("browser.invalid_target_short") };
@@ -223,8 +245,7 @@ export class BrowserSession {
             return { success: false, output: t("browser.text_required") };
         }
         try {
-            const script = buildTypeScript(target, text);
-            await this.page.evaluate(script);
+            await this.driver.evaluate(buildTypeScript(target, text));
             const snapshot = await this.takeSnapshot();
             return { success: true, output: snapshot };
         }
@@ -236,17 +257,17 @@ export class BrowserSession {
         }
     }
     async scroll(direction) {
-        const err = await this.ensurePage();
+        const err = await this.ensureDriver();
         if (err)
             return err;
-        if (!this.page)
+        if (!this.driver)
             return { success: false, output: "No page" };
         const dir = direction;
         if (!["up", "down", "top", "bottom"].includes(dir)) {
             return { success: false, output: t("browser.direction_invalid") };
         }
         try {
-            await this.page.evaluate(buildScrollScript(dir));
+            await this.driver.evaluate(buildScrollScript(dir));
             await new Promise((r) => setTimeout(r, 300));
             const snapshot = await this.takeSnapshot();
             return { success: true, output: snapshot };
@@ -259,56 +280,46 @@ export class BrowserSession {
         }
     }
     async back() {
-        const err = await this.ensurePage();
+        const err = await this.ensureDriver();
         if (err)
             return err;
-        if (!this.page)
+        if (!this.driver)
             return { success: false, output: "No page" };
-        await this.page
-            .goBack({
-            waitUntil: "domcontentloaded",
-            timeout: this.config.navigationTimeout,
-        })
-            .catch(() => { });
+        await this.driver.goBack(this.config.navigationTimeout);
         await new Promise((r) => setTimeout(r, 300));
         const snapshot = await this.takeSnapshot();
         return { success: true, output: snapshot };
     }
     async forward() {
-        const err = await this.ensurePage();
+        const err = await this.ensureDriver();
         if (err)
             return err;
-        if (!this.page)
+        if (!this.driver)
             return { success: false, output: "No page" };
-        await this.page
-            .goForward({
-            waitUntil: "domcontentloaded",
-            timeout: this.config.navigationTimeout,
-        })
-            .catch(() => { });
+        await this.driver.goForward(this.config.navigationTimeout);
         await new Promise((r) => setTimeout(r, 300));
         const snapshot = await this.takeSnapshot();
         return { success: true, output: snapshot };
     }
     async screenshot() {
-        const err = await this.ensurePage();
+        const err = await this.ensureDriver();
         if (err)
             return err;
-        if (!this.page)
+        if (!this.driver)
             return { success: false, output: "No page" };
-        const buffer = await this.page.screenshot({ type: "png", fullPage: false });
+        const buffer = await this.driver.screenshot();
         const snapshot = await this.takeSnapshot();
         return { success: true, output: snapshot, screenshot: buffer };
     }
     async snapshot() {
-        const err = await this.ensurePage();
+        const err = await this.ensureDriver();
         if (err)
             return err;
         const snap = await this.takeSnapshot();
         return { success: true, output: snap };
     }
     async wait(ms) {
-        const err = await this.ensurePage();
+        const err = await this.ensureDriver();
         if (err)
             return err;
         await new Promise((r) => setTimeout(r, Math.min(ms, 10000)));
@@ -317,17 +328,9 @@ export class BrowserSession {
     }
     async close() {
         await this.saveCookies();
-        if (this.page) {
-            await this.page.close().catch(() => { });
-            this.page = null;
-        }
-        if (this.context) {
-            await this.context.close().catch(() => { });
-            this.context = null;
-        }
-        if (this.browser) {
-            await this.browser.close().catch(() => { });
-            this.browser = null;
+        if (this.driver) {
+            await this.driver.close();
+            this.driver = null;
         }
         this.state = { isOpen: false, url: null, title: null, elementCount: 0 };
         return { success: true, output: t("browser.closed") };

package/dist/modules/browser/snapshot.js

@@ -1,46 +1,50 @@
-import { t } from '../../i18n/index';
+import { t } from "../../i18n/index";
+import { DEFAULT_BROWSER_CONFIG } from "./types";
 function inferRole(tag, type) {
     const t = tag.toLowerCase();
-    if (t === 'a')
-        return 'link';
-    if (t === 'button')
-        return 'button';
-    if (t === 'input') {
+    if (t === "a")
+        return "link";
+    if (t === "button")
+        return "button";
+    if (t === "input") {
         const inputType = type?.toLowerCase();
-        if (inputType === 'submit' || inputType === 'button')
-            return 'button';
-        if (inputType === 'checkbox')
-            return 'checkbox';
-        if (inputType === 'radio')
-            return 'radio';
-        return 'textbox';
+        if (inputType === "submit" || inputType === "button")
+            return "button";
+        if (inputType === "checkbox")
+            return "checkbox";
+        if (inputType === "radio")
+            return "radio";
+        return "textbox";
     }
-    if (t === 'textarea')
-        return 'textbox';
-    if (t === 'select')
-        return 'combobox';
-    return 'widget';
+    if (t === "textarea")
+        return "textbox";
+    if (t === "select")
+        return "combobox";
+    return "widget";
 }
 function getName(tag, attrs, html, matchIndex) {
-    const fromAttr = (attrs['aria-label'] ||
-        attrs['placeholder'] ||
-        attrs['title'] ||
-        attrs['alt'] ||
-        attrs['value'] ||
-        attrs['name'] ||
-        '');
+    const fromAttr = attrs["aria-label"] ||
+        attrs["placeholder"] ||
+        attrs["title"] ||
+        attrs["alt"] ||
+        attrs["value"] ||
+        attrs["name"] ||
+        "";
     if (fromAttr)
         return fromAttr;
     const afterTag = html.slice(matchIndex);
-    const closeIdx = afterTag.indexOf('>');
+    const closeIdx = afterTag.indexOf(">");
     if (closeIdx === -1)
-        return '';
+        return "";
     const afterOpen = afterTag.slice(closeIdx + 1);
     const endTag = `</${tag}>`;
     const endIdx = afterOpen.indexOf(endTag);
     if (endIdx === -1)
-        return '';
-    const text = afterOpen.slice(0, endIdx).replace(/<[^>]+>/g, '').trim();
+        return "";
+    const text = afterOpen
+        .slice(0, endIdx)
+        .replace(/<[^>]+>/g, "")
+        .trim();
     return text.slice(0, 50);
 }
 export function extractInteractiveElements(html, maxElements = 30) {
@@ -56,23 +60,21 @@ export function extractInteractiveElements(html, maxElements = 30) {
         const attrRegex = /(\w[\w-]*)(?:\s*=\s*(?:"([^"]*)"|'([^']*)'|(\S+)))?/g;
         let attrMatch;
         while ((attrMatch = attrRegex.exec(attrStr)) !== null) {
-            attrs[attrMatch[1].toLowerCase()] = attrMatch[2] ?? attrMatch[3] ?? attrMatch[4] ?? '';
+            attrs[attrMatch[1].toLowerCase()] = attrMatch[2] ?? attrMatch[3] ?? attrMatch[4] ?? "";
         }
-        if (attrs['style']?.includes('display:none') || attrs['style']?.includes('display: none'))
+        if (attrs["style"]?.includes("display:none") || attrs["style"]?.includes("display: none"))
             continue;
-        if (attrs['hidden'] !== undefined)
+        if (attrs["hidden"] !== undefined)
             continue;
-        if (attrs['aria-hidden'] === 'true')
+        if (attrs["aria-hidden"] === "true")
             continue;
-        if (tag === 'input' && attrs['type'] === 'hidden')
+        if (tag === "input" && attrs["type"] === "hidden")
             continue;
-        const role = attrs['role'] || inferRole(tag, attrs['type']);
-        const isInteractive = [
-            'a', 'button', 'input', 'textarea', 'select',
-        ].includes(tag) || attrs['role'] !== undefined;
+        const role = attrs["role"] || inferRole(tag, attrs["type"]);
+        const isInteractive = ["a", "button", "input", "textarea", "select"].includes(tag) || attrs["role"] !== undefined;
         if (!isInteractive)
             continue;
-        if (tag === 'a' && !attrs['href'])
+        if (tag === "a" && !attrs["href"])
             continue;
         const name = getName(tag, attrs, html, match.index);
         elements.push({
@@ -80,35 +82,67 @@ export function extractInteractiveElements(html, maxElements = 30) {
             tag,
             role,
             name,
-            value: attrs['value'],
-            href: attrs['href'],
+            value: attrs["value"],
+            href: attrs["href"],
             visible: true,
         });
     }
     return elements;
 }
-export function formatSnapshot(snapshot) {
+export function truncateText(text, maxChars) {
+    if (maxChars <= 0)
+        return "";
+    if (text.length <= maxChars)
+        return text;
+    const cut = text.slice(0, maxChars);
+    const lastNewline = cut.lastIndexOf("\n");
+    const safe = lastNewline > maxChars * 0.6 ? cut.slice(0, lastNewline) : cut;
+    return `${safe}\n${t("browser.truncated")}`;
+}
+export function formatSnapshot(snapshot, maxContentChars = DEFAULT_BROWSER_CONFIG.maxContentChars) {
     const lines = [];
     lines.push(`Page: "${snapshot.title}"`);
     lines.push(`URL: ${snapshot.url}`);
-    lines.push('');
+    lines.push("");
     if (snapshot.elements.length === 0 && !snapshot.truncated) {
-        lines.push(t('browser.no_elements'));
-        return lines.join('\n');
+        lines.push(t("browser.no_elements"));
+    }
+    else {
+        for (const el of snapshot.elements) {
+            let line = `[${el.index}] ${el.role}`;
+            if (el.name)
+                line += ` "${el.name}"`;
+            if (el.href)
+                line += ` → ${el.href}`;
+            if (el.value)
+                line += ` = "${el.value}"`;
+            lines.push(line);
+        }
+        if (snapshot.truncated) {
+            lines.push("");
+            lines.push(t("browser.more_elements"));
+        }
     }
-    for (const el of snapshot.elements) {
-        let line = `[${el.index}] ${el.role}`;
-        if (el.name)
-            line += ` "${el.name}"`;
-        if (el.href)
-            line += ` → ${el.href}`;
-        if (el.value)
-            line += ` = "${el.value}"`;
-        lines.push(line);
+    if (snapshot.content) {
+        lines.push("");
+        lines.push(t("browser.content_header"));
+        for (const line of truncateText(snapshot.content, maxContentChars).split("\n")) {
+            lines.push(`- ${line}`);
+        }
+    }
+    if (snapshot.console.length > 0) {
+        lines.push("");
+        lines.push(t("browser.console_header"));
+        for (const entry of snapshot.console) {
+            lines.push(`[${entry.type}] ${entry.text}`);
+        }
     }
-    if (snapshot.truncated) {
-        lines.push('');
-        lines.push(t('browser.more_elements'));
+    if (snapshot.networkErrors.length > 0) {
+        lines.push("");
+        lines.push(t("browser.network_errors_header"));
+        for (const err of snapshot.networkErrors) {
+            lines.push(`${err.method} ${err.url} → ${err.error}`);
+        }
     }
-    return lines.join('\n');
+    return lines.join("\n");
 }

package/dist/modules/browser/types.js

@@ -1,8 +1,11 @@
 export const DEFAULT_BROWSER_CONFIG = {
     headless: true,
     maxElements: 30,
+    maxContentChars: 2500,
+    maxConsoleEntries: 40,
+    maxConsoleLineChars: 400,
     screenshotMaxWidth: 1280,
-    cookieDir: '',
+    cookieDir: "",
     viewportWidth: 1280,
     viewportHeight: 720,
     navigationTimeout: 15000,

package/dist/modules/certification/cli.js

@@ -7,7 +7,7 @@ import { t } from "../../i18n/index";
 import { pc } from "../../ui/colors";
 import { loadScenarios, filterByTags } from "./loader";
 import { runScenario, findMmaRoot } from "./runner";
-import { readManifest, upsertCertification, removeCertification, } from "./manifest";
+import { readManifest, upsertCertification, removeCertification } from "./manifest";
 const HERE = dirname(fileURLToPath(import.meta.url));
 const MMA_ROOT = findMmaRoot(HERE);
 const USER_SCENARIO_DIR = join(homedir(), ".mma", "certification", "scenarios");
@@ -85,9 +85,7 @@ export async function certify(opts) {
             defaultReps: opts.reps,
             defaultThreshold: 2,
             onRep: (id, rep, reps, passed, failures) => {
-                const word = passed
-                    ? pc.green(t("cli.cert_rep_pass"))
-                    : pc.red(t("cli.cert_rep_fail"));
+                const word = passed ? pc.green(t("cli.cert_rep_pass")) : pc.red(t("cli.cert_rep_fail"));
                 console.log(`[${idx}/${total}] ${id} (${rep}/${reps})... ${word}`);
                 if (!passed)
                     console.log(`    ${pc.dim(failures.join("; "))}`);

package/dist/modules/certification/fact-checker.js

@@ -71,9 +71,7 @@ function describe(check) {
         case "dirExists":
             return `directory missing: ${check.path}`;
         case "fileContent": {
-            const what = check.contains !== undefined
-                ? `contains "${check.contains}"`
-                : `equals "${check.equals}"`;
+            const what = check.contains !== undefined ? `contains "${check.contains}"` : `equals "${check.equals}"`;
             return `${check.path} does not ${what}`;
         }
         case "fileRegex":

package/dist/modules/certification/loader.js

@@ -35,9 +35,7 @@ export function validateScenario(s) {
         if (!CHECK_TYPES.includes(c.type)) {
             errors.push(`[${s.id}] unknown check type: ${c.type}`);
         }
-        if (c.type === "fileContent" &&
-            c.contains === undefined &&
-            c.equals === undefined) {
+        if (c.type === "fileContent" && c.contains === undefined && c.equals === undefined) {
             errors.push(`[${s.id}] fileContent needs contains or equals`);
         }
     }
@@ -48,9 +46,7 @@ export function validateScenario(s) {
         (!Number.isInteger(s.passThreshold) || s.passThreshold < 1)) {
         errors.push(`[${s.id}] passThreshold must be a positive integer`);
     }
-    if (s.passThreshold !== undefined &&
-        s.reps !== undefined &&
-        s.passThreshold > s.reps) {
+    if (s.passThreshold !== undefined && s.reps !== undefined && s.passThreshold > s.reps) {
         errors.push(`[${s.id}] passThreshold > reps (must be <= reps)`);
     }
     return errors;
@@ -96,9 +92,7 @@ function normalizeScenario(data, file) {
         prompt: String(d.prompt ?? ""),
         reps: typeof d.reps === "number" ? d.reps : undefined,
         passThreshold: typeof d.passThreshold === "number" ? d.passThreshold : undefined,
-        fixtures: Array.isArray(d.fixtures)
-            ? d.fixtures
-            : undefined,
+        fixtures: Array.isArray(d.fixtures) ? d.fixtures : undefined,
         checks: Array.isArray(d.checks) ? d.checks : [],
         skipReason: typeof d.skipReason === "string" ? d.skipReason : undefined,
     };

package/dist/modules/certification/runner.js

@@ -98,10 +98,7 @@ export function resolveMmaEntry(mmaRoot) {
     return join(mmaRoot, "dist", "main.js");
 }
 export function findMmaRoot(fromDir) {
-    const candidates = [
-        resolve(fromDir, "..", "..", ".."),
-        resolve(fromDir, ".."),
-    ];
+    const candidates = [resolve(fromDir, "..", "..", ".."), resolve(fromDir, "..")];
     for (const c of candidates) {
         if (existsSync(join(c, "package.json")))
             return c;