micro-models-agent 0.47.0 → 0.48.1

package/dist/modules/browser/session.js

@@ -0,0 +1,338 @@
+import { createBrowserDriver } from "./driver";
+import { extractInteractiveElements, formatSnapshot } from "./snapshot";
+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;
+    constructor(threshold = 3) {
+        this.threshold = threshold;
+    }
+    record(action, args, url) {
+        this.history.push({ action, args, url });
+        if (this.history.length < this.threshold)
+            return null;
+        const recent = this.history.slice(-this.threshold);
+        const allSame = recent.every((h) => h.action === recent[0].action &&
+            h.url === recent[0].url &&
+            JSON.stringify(h.args) === JSON.stringify(recent[0].args));
+        if (allSame) {
+            return t("browser.repeated_action", {
+                action,
+                threshold: this.threshold,
+            });
+        }
+        return null;
+    }
+    reset() {
+        this.history = [];
+    }
+}
+export class BrowserSession {
+    driver = null;
+    config;
+    cookieStore;
+    state = {
+        isOpen: false,
+        url: null,
+        title: null,
+        elementCount: 0,
+    };
+    actionTracker = new BrowserActionTracker(3);
+    constructor(config) {
+        this.config = config;
+        this.cookieStore = new CookieStore(config.cookieDir);
+    }
+    getState() {
+        return { ...this.state };
+    }
+    async execute(action, args) {
+        try {
+            let result;
+            switch (action) {
+                case "open":
+                    result = await this.open(String(args.url || ""));
+                    break;
+                case "click":
+                    result = await this.click(Number(args.target));
+                    break;
+                case "type":
+                    result = await this.type(Number(args.target), String(args.text || ""));
+                    break;
+                case "scroll":
+                    result = await this.scroll(String(args.direction || "down"));
+                    break;
+                case "back":
+                    result = await this.back();
+                    break;
+                case "forward":
+                    result = await this.forward();
+                    break;
+                case "screenshot":
+                    result = await this.screenshot();
+                    break;
+                case "snapshot":
+                    result = await this.snapshot();
+                    break;
+                case "close":
+                    result = await this.close();
+                    break;
+                case "wait":
+                    result = await this.wait(Number(args.ms || 1000));
+                    break;
+                default:
+                    return {
+                        success: false,
+                        output: t("browser.unknown_action", { action }),
+                    };
+            }
+            if (action !== "open") {
+                const warning = this.actionTracker.record(action, args, this.driver?.url() || "");
+                if (warning && result.success) {
+                    result.output = result.output + "\n\n⚠️ " + warning;
+                }
+            }
+            return result;
+        }
+        catch (err) {
+            return {
+                success: false,
+                output: t("browser.error", { message: err.message }),
+            };
+        }
+    }
+    async ensureDriver() {
+        if (!this.driver) {
+            return { success: false, output: t("browser.no_page") };
+        }
+        return null;
+    }
+    async launch() {
+        if (this.driver)
+            return;
+        this.driver = await createBrowserDriver(this.config);
+        const savedCookies = await this.cookieStore.load();
+        if (savedCookies.length > 0) {
+            await this.driver.addCookies(savedCookies);
+        }
+    }
+    async saveCookies() {
+        if (!this.driver)
+            return;
+        const cookies = await this.driver.cookies();
+        await this.cookieStore.save(cookies);
+    }
+    async takeSnapshot() {
+        if (!this.driver)
+            return "No page open.";
+        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);
+        this.state = {
+            isOpen: true,
+            url,
+            title,
+            elementCount: elements.length,
+        };
+        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://")) {
+            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.driver)
+            return { success: false, output: t("browser.create_page_failed") };
+        this.actionTracker.reset();
+        this.driver.resetEventLog();
+        try {
+            await this.driver.goto(url, this.config.navigationTimeout);
+        }
+        catch (err) {
+            return {
+                success: false,
+                output: t("browser.nav_failed", { message: err.message }),
+            };
+        }
+        const snapshot = await this.takeSnapshot();
+        await this.saveCookies();
+        return { success: true, output: snapshot };
+    }
+    async click(target) {
+        const err = await this.ensureDriver();
+        if (err)
+            return err;
+        if (!this.driver)
+            return { success: false, output: "No page" };
+        if (!target || target < 1) {
+            return { success: false, output: t("browser.invalid_target") };
+        }
+        try {
+            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();
+            return { success: true, output: snapshot };
+        }
+        catch (err) {
+            return {
+                success: false,
+                output: t("browser.click_failed", { message: err.message }),
+            };
+        }
+    }
+    async type(target, text) {
+        const err = await this.ensureDriver();
+        if (err)
+            return err;
+        if (!this.driver)
+            return { success: false, output: "No page" };
+        if (!target || target < 1) {
+            return { success: false, output: t("browser.invalid_target_short") };
+        }
+        if (!text) {
+            return { success: false, output: t("browser.text_required") };
+        }
+        try {
+            await this.driver.evaluate(buildTypeScript(target, text));
+            const snapshot = await this.takeSnapshot();
+            return { success: true, output: snapshot };
+        }
+        catch (err) {
+            return {
+                success: false,
+                output: t("browser.type_failed", { message: err.message }),
+            };
+        }
+    }
+    async scroll(direction) {
+        const err = await this.ensureDriver();
+        if (err)
+            return err;
+        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.driver.evaluate(buildScrollScript(dir));
+            await new Promise((r) => setTimeout(r, 300));
+            const snapshot = await this.takeSnapshot();
+            return { success: true, output: snapshot };
+        }
+        catch (err) {
+            return {
+                success: false,
+                output: t("browser.scroll_failed", { message: err.message }),
+            };
+        }
+    }
+    async back() {
+        const err = await this.ensureDriver();
+        if (err)
+            return err;
+        if (!this.driver)
+            return { success: false, output: "No page" };
+        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.ensureDriver();
+        if (err)
+            return err;
+        if (!this.driver)
+            return { success: false, output: "No page" };
+        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.ensureDriver();
+        if (err)
+            return err;
+        if (!this.driver)
+            return { success: false, output: "No page" };
+        const buffer = await this.driver.screenshot();
+        const snapshot = await this.takeSnapshot();
+        return { success: true, output: snapshot, screenshot: buffer };
+    }
+    async snapshot() {
+        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.ensureDriver();
+        if (err)
+            return err;
+        await new Promise((r) => setTimeout(r, Math.min(ms, 10000)));
+        const snapshot = await this.takeSnapshot();
+        return { success: true, output: snapshot };
+    }
+    async close() {
+        await this.saveCookies();
+        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

@@ -0,0 +1,148 @@
+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") {
+        const inputType = type?.toLowerCase();
+        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";
+}
+function getName(tag, attrs, html, matchIndex) {
+    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(">");
+    if (closeIdx === -1)
+        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 text.slice(0, 50);
+}
+export function extractInteractiveElements(html, maxElements = 30) {
+    const elements = [];
+    const tagRegex = /<(a|button|input|textarea|select|div|span)([^>]*)>/gi;
+    let match;
+    while ((match = tagRegex.exec(html)) !== null) {
+        if (elements.length >= maxElements)
+            break;
+        const tag = match[1].toLowerCase();
+        const attrStr = match[2];
+        const attrs = {};
+        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] ?? "";
+        }
+        if (attrs["style"]?.includes("display:none") || attrs["style"]?.includes("display: none"))
+            continue;
+        if (attrs["hidden"] !== undefined)
+            continue;
+        if (attrs["aria-hidden"] === "true")
+            continue;
+        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;
+        if (!isInteractive)
+            continue;
+        if (tag === "a" && !attrs["href"])
+            continue;
+        const name = getName(tag, attrs, html, match.index);
+        elements.push({
+            index: elements.length + 1,
+            tag,
+            role,
+            name,
+            value: attrs["value"],
+            href: attrs["href"],
+            visible: true,
+        });
+    }
+    return elements;
+}
+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("");
+    if (snapshot.elements.length === 0 && !snapshot.truncated) {
+        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"));
+        }
+    }
+    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.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");
+}

package/dist/modules/browser/types.js

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

package/dist/modules/certification/cli.js

@@ -0,0 +1,174 @@
+import { rmSync } from "fs";
+import { homedir } from "os";
+import { join, dirname } from "path";
+import { fileURLToPath } from "url";
+import { existsSync, readFileSync } from "fs";
+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";
+const HERE = dirname(fileURLToPath(import.meta.url));
+const MMA_ROOT = findMmaRoot(HERE);
+const USER_SCENARIO_DIR = join(homedir(), ".mma", "certification", "scenarios");
+function readVersion() {
+    const candidates = [join(MMA_ROOT, "package.json")];
+    for (const p of candidates) {
+        if (existsSync(p)) {
+            try {
+                const raw = JSON.parse(readFileSync(p, "utf-8"));
+                if (raw.version)
+                    return raw.version;
+            }
+            catch {
+                // Broken package.json — fall back to the default version
+            }
+        }
+    }
+    return "0.0.0";
+}
+export function parseTags(s) {
+    return s
+        .split(",")
+        .map((x) => x.trim())
+        .filter(Boolean);
+}
+export async function certify(opts) {
+    const providerUrl = opts.providerUrl || opts.config.provider.baseUrl;
+    if (opts.tags.includes("security") && !opts.config.security?.enabled) {
+        console.error(pc.red(t("cli.cert_security_required")));
+        process.exitCode = 1;
+        return;
+    }
+    const { scenarios, errors } = loadScenarios(USER_SCENARIO_DIR);
+    for (const e of errors)
+        console.error(pc.yellow(`  ${e}`));
+    const selected = filterByTags(scenarios, opts.tags);
+    if (selected.length === 0) {
+        console.error(pc.red(t("cli.cert_no_scenarios", { tags: opts.tags.join(",") })));
+        process.exitCode = 1;
+        return;
+    }
+    const manifest = readManifest();
+    const existing = manifest.certifications.find((e) => e.model === opts.name && e.providerUrl === providerUrl);
+    if (existing && !opts.force) {
+        console.error(pc.yellow(t("cli.cert_exists", { model: opts.name })));
+        console.error(pc.yellow(t("cli.cert_exists_hint")));
+        process.exitCode = 1;
+        return;
+    }
+    console.log(t("cli.cert_started", { model: opts.name, provider: providerUrl }));
+    const sandboxBase = join(process.cwd(), ".mma", "certification");
+    const results = [];
+    const total = selected.length;
+    let idx = 0;
+    for (const scenario of selected) {
+        idx++;
+        if (scenario.mode === "skip") {
+            console.log(pc.dim(`[${idx}/${total}] ${scenario.id} ... skipped`));
+            results.push({
+                id: scenario.id,
+                title: scenario.title,
+                status: "skipped",
+                passed: 0,
+                of: 0,
+            });
+            continue;
+        }
+        const res = await runScenario(scenario, {
+            model: opts.name,
+            providerUrl,
+            providerKey: opts.providerKey,
+            contextWindow: opts.contextWindow,
+            mmaRoot: MMA_ROOT,
+            sandboxBase,
+            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"));
+                console.log(`[${idx}/${total}] ${id} (${rep}/${reps})... ${word}`);
+                if (!passed)
+                    console.log(`    ${pc.dim(failures.join("; "))}`);
+            },
+        });
+        results.push(res);
+    }
+    if (opts.clean) {
+        try {
+            rmSync(sandboxBase, { recursive: true, force: true });
+        }
+        catch {
+            /* ignore */
+        }
+    }
+    const suite = summarize(results);
+    const entry = {
+        model: opts.name,
+        providerUrl,
+        mmaVersion: readVersion(),
+        certifiedAt: new Date().toISOString(),
+        suite,
+        results,
+    };
+    upsertCertification(entry);
+    console.log(t("cli.cert_done", {
+        passed: String(suite.passed),
+        failed: String(suite.failed),
+        skipped: String(suite.skipped),
+        total: String(suite.total),
+    }));
+    printResults(results);
+}
+export async function certStatus(name, config) {
+    const m = readManifest();
+    const providerUrl = config.provider.baseUrl;
+    const entry = m.certifications.find((e) => e.model === name && e.providerUrl === providerUrl);
+    if (!entry) {
+        console.log(t("cli.cert_not_found", { model: name }));
+        return;
+    }
+    console.log(`${t("cli.cert_provider_col")}: ${entry.providerUrl}`);
+    console.log(`${t("cli.cert_version_col")}: ${entry.mmaVersion}  ${t("cli.cert_date_col")}: ${entry.certifiedAt.slice(0, 10)}`);
+    console.log(`${t("cli.cert_suite_col")}: ${entry.suite.passed} pass / ${entry.suite.failed} fail / ${entry.suite.skipped} skipped`);
+    printResults(entry.results);
+}
+export async function certList() {
+    const m = readManifest();
+    if (m.certifications.length === 0) {
+        console.log(t("cli.cert_empty"));
+        return;
+    }
+    for (const e of m.certifications) {
+        console.log(`  ${pc.green("✔")} ${e.model}  ${pc.dim(e.providerUrl)}  ${e.mmaVersion}  ${e.certifiedAt.slice(0, 10)}  ${e.suite.passed}/${e.suite.total} pass`);
+    }
+}
+export async function uncertify(name, config) {
+    const removed = removeCertification(name, config.provider.baseUrl);
+    if (removed)
+        console.log(t("cli.cert_uncertified", { model: name }));
+    else
+        console.log(t("cli.cert_not_found", { model: name }));
+}
+function summarize(results) {
+    return {
+        passed: results.filter((r) => r.status === "pass").length,
+        failed: results.filter((r) => r.status === "fail").length,
+        skipped: results.filter((r) => r.status === "skipped").length,
+        total: results.length,
+    };
+}
+function printResults(results) {
+    for (const r of results) {
+        const icon = r.status === "pass"
+            ? pc.green("✔")
+            : r.status === "fail"
+                ? pc.red("✘")
+                : r.status === "skipped"
+                    ? pc.dim("–")
+                    : pc.yellow("!");
+        const detail = r.status === "skipped" ? pc.dim(r.title) : `${r.passed}/${r.of}`;
+        console.log(`  ${icon} ${r.id}  ${detail}`);
+        if (r.error)
+            console.log(`    ${pc.dim(r.error)}`);
+    }
+}