micro-models-agent 0.41.2 → 0.43.0

package/package.json

@@ -1,48 +1,48 @@
-{
-  "name": "micro-models-agent",
-  "version": "0.41.2",
-  "description": "Micro Models Agent (MMA) — LLM agent harness for small models (Qwen3.5-9B, 32K-64K context)",
-  "type": "module",
-  "bin": {
-    "mma": "bin/mma.mjs"
-  },
-  "files": [
-    "dist/",
-    "bin/"
-  ],
-  "engines": {
-    "node": ">=20"
-  },
-  "scripts": {
-    "mma": "bun run src/cli/main.ts",
-    "build": "bun run build:tsc && bun run build:copy-assets",
-    "build:tsc": "tsc -p tsconfig.build.json",
-    "build:copy-assets": "bun run scripts/copy-assets.ts",
-    "build:prod": "bun run 'build:bundle' && bun run 'build:copy-assets'",
-    "build:clean": "cmd /c \"if exist dist rmdir /s /q dist\"",
-    "build:bundle": "bun build ./src/cli/main.ts --outfile ./dist/main.js --target node --format esm --external playwright",
-    "dev": "bun --watch src/cli/main.ts",
-    "typecheck": "tsc --noEmit",
-    "test": "bun test",
-    "test:watch": "bun test --watch",
-    "test:integration": "vitest run --config vitest.integration.config.ts",
-    "format": "prettier --write \"src/**/*.{ts,js,mjs,json}\" \"tests/**/*.{ts,js,json}\" \"scripts/**/*.ts\" \"*.{ts,json}\"",
-    "format:check": "prettier --check \"src/**/*.{ts,js,mjs,json}\" \"tests/**/*.{ts,js,json}\" \"scripts/**/*.ts\" \"*.{ts,json}\""
-  },
-  "dependencies": {
-    "commander": "^12.0.0",
-    "js-tiktoken": "^1.0.0",
-    "jsonrepair": "^3.15.0",
-    "picocolors": "^1.1.1",
-    "playwright": "^1.62.0",
-    "string-width": "^8.2.2",
-    "yaml": "^2.9.0"
-  },
-  "devDependencies": {
-    "@types/bun": "^1.3.14",
-    "@types/node": "^22.20.1",
-    "prettier": "^3.9.6",
-    "typescript": "^5.9.3",
-    "vitest": "^4.1.10"
-  }
-}
+{
+  "name": "micro-models-agent",
+  "version": "0.43.0",
+  "description": "Micro Models Agent (MMA) — LLM agent harness for small models (Qwen3.5-9B, 32K-64K context)",
+  "type": "module",
+  "bin": {
+    "mma": "bin/mma.mjs"
+  },
+  "files": [
+    "dist/",
+    "bin/"
+  ],
+  "engines": {
+    "node": ">=20"
+  },
+  "scripts": {
+    "mma": "bun run src/cli/main.ts",
+    "build": "bun run build:tsc && bun run build:copy-assets",
+    "build:tsc": "tsc -p tsconfig.build.json",
+    "build:copy-assets": "bun run scripts/copy-assets.ts",
+    "build:prod": "bun run 'build:bundle' && bun run 'build:copy-assets'",
+    "build:clean": "cmd /c \"if exist dist rmdir /s /q dist\"",
+    "build:bundle": "bun build ./src/cli/main.ts --outfile ./dist/main.js --target node --format esm --external playwright",
+    "dev": "bun --watch src/cli/main.ts",
+    "typecheck": "tsc --noEmit",
+    "test": "bun test",
+    "test:watch": "bun test --watch",
+    "test:integration": "vitest run --config vitest.integration.config.ts",
+    "format": "prettier --write \"src/**/*.{ts,js,mjs,json}\" \"tests/**/*.{ts,js,json}\" \"scripts/**/*.ts\" \"*.{ts,json}\"",
+    "format:check": "prettier --check \"src/**/*.{ts,js,mjs,json}\" \"tests/**/*.{ts,js,json}\" \"scripts/**/*.ts\" \"*.{ts,json}\""
+  },
+  "dependencies": {
+    "commander": "^12.0.0",
+    "js-tiktoken": "^1.0.0",
+    "jsonrepair": "^3.15.0",
+    "picocolors": "^1.1.1",
+    "playwright": "^1.62.0",
+    "string-width": "^8.2.2",
+    "yaml": "^2.9.0"
+  },
+  "devDependencies": {
+    "@types/bun": "^1.3.14",
+    "@types/node": "^22.20.1",
+    "prettier": "^3.9.6",
+    "typescript": "^5.9.3",
+    "vitest": "^4.1.10"
+  }
+}

package/dist/cli/plugin-commands.js

@@ -1,36 +0,0 @@
-import { bootstrap } from "../core/bootstrap";
-import { readMmaVersion } from "../core/version";
-import { t } from "../i18n/index";
-/**
- * Create the `mma plugins` subcommand group.
- */
-export function createPluginCommand(program) {
-    const pluginsCmd = program.command("plugins").description(t("cli.plugins.description"));
-    pluginsCmd
-        .command("list")
-        .description(t("cli.plugins.list"))
-        .option("-a, --all", t("cli.plugins.all"))
-        .action(async (cmdOpts) => {
-        const { pluginManager } = await bootstrap();
-        const all = cmdOpts.all === true;
-        let infos = pluginManager.getPluginInfos();
-        if (!all) {
-            infos = infos.filter(({ plugin }) => !plugin.isBuiltin);
-        }
-        if (infos.length === 0) {
-            console.log(t("cli.plugins.none"));
-            return;
-        }
-        const mmaVersion = readMmaVersion();
-        console.log(t("cli.plugins.header", { count: String(infos.length), mma: mmaVersion }));
-        for (const { plugin, source } of infos) {
-            const version = plugin.version || "-";
-            const origin = source || "builtin";
-            const builtin = plugin.isBuiltin ? t("cli.plugins.builtin_mark") : " ";
-            console.log(`  ${builtin} ${plugin.name}  v${version}  [${origin}]`);
-        }
-        if (!all) {
-            console.log(t("cli.plugins.only_external"));
-        }
-    });
-}

package/dist/cli/run-result.js

@@ -1,22 +0,0 @@
-import { t } from "../i18n/index";
-import { pc } from "../ui/colors";
-/**
- * Render a single-run AgentResult to the terminal (non-JSON mode) and return
- * the process exit code.
- *
- * On failure only the error is printed. The model's `text` (which is the last
- * *accepted* message, i.e. possibly stale after an audit/hallucination error)
- * was already streamed live during the run — re-printing it here misleadingly
- * suggests the task succeeded.
- */
-export function printRunResult(result, flush) {
-    flush();
-    if (result.success) {
-        if (!result.text) {
-            console.log(pc.yellow(t("cli.no_output")));
-        }
-        return 0;
-    }
-    console.error(`${t("error.prefix")}${result.error}`);
-    return 1;
-}

package/dist/core/version.js

@@ -1,24 +0,0 @@
-import { existsSync, readFileSync } from "fs";
-import { join, dirname } from "path";
-import { fileURLToPath } from "url";
-/**
- * Read the MMA version from package.json at runtime (never a static import —
- * bundlers inline a stale value at build time, see design rule #12).
- */
-export function readMmaVersion() {
-    const here = dirname(fileURLToPath(import.meta.url));
-    const candidates = [join(here, "..", "..", "package.json"), join(here, "..", "package.json")];
-    for (const p of candidates) {
-        if (existsSync(p)) {
-            try {
-                const raw = JSON.parse(readFileSync(p, "utf8"));
-                if (raw.version)
-                    return raw.version;
-            }
-            catch {
-                // Broken package.json — fall through to the next candidate
-            }
-        }
-    }
-    return "0.0.0";
-}

package/dist/modules/artifacts/store.js

@@ -1,61 +0,0 @@
-import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
-import { resolve, relative, isAbsolute } from "node:path";
-export class ArtifactStore {
-    root;
-    constructor(opts) {
-        const artifactsDir = opts.artifactsDir || ".mma/artifacts";
-        this.root = resolve(opts.baseDir, artifactsDir, opts.sessionId);
-    }
-    /** Normalize to [a-zA-Z0-9._-]; never empty, never "." or "..". */
-    static sanitizeName(name) {
-        // Strip traversal prefixes so "../../etc/passwd" becomes "etc_passwd",
-        // never ".._.._etc_passwd".
-        const stripped = name.replace(/^(\.\.?[\\/])+/g, "").replace(/^\.{1,2}$/, "");
-        const cleaned = stripped
-            .replace(/[^a-zA-Z0-9._-]/g, "_")
-            .replace(/_{2,}/g, "_")
-            .replace(/^_+|_+$/g, "");
-        if (cleaned === "" || cleaned === "." || cleaned === "..") {
-            return "artifact";
-        }
-        return cleaned;
-    }
-    /** True when `candidate` is strictly inside (or equal to) `root`. */
-    static isInside(root, candidate) {
-        const rel = relative(root, candidate);
-        if (rel === "")
-            return true;
-        return !rel.startsWith("..") && !isAbsolute(rel);
-    }
-    /**
-     * Persist content to <root>/<name>.<ext> and return the absolute path.
-     * Throws if the resolved path escapes root (defense in depth — sanitizeName already removes separators).
-     */
-    save(name, content, ext = "md") {
-        const safe = ArtifactStore.sanitizeName(name);
-        const dir = resolve(this.root);
-        mkdirSync(dir, { recursive: true });
-        const abs = resolve(dir, `${safe}.${ext}`);
-        if (!ArtifactStore.isInside(dir, abs)) {
-            throw new Error(`Artifact path escapes root: ${abs}`);
-        }
-        writeFileSync(abs, content, "utf8");
-        return abs;
-    }
-    /** Read an artifact by its file name (relative to root); null when outside the root or missing. */
-    read(path) {
-        const abs = resolve(this.root, path);
-        if (!ArtifactStore.isInside(this.root, abs))
-            return null;
-        if (!existsSync(abs))
-            return null;
-        return readFileSync(abs, "utf8");
-    }
-    /** First maxChars chars (trimmed) + truncation marker. */
-    summary(content, maxChars) {
-        if (content.length <= maxChars)
-            return content;
-        const head = content.slice(0, maxChars).trimEnd();
-        return `${head}\n…[truncated: ${content.length - maxChars} chars]`;
-    }
-}

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

@@ -1,199 +0,0 @@
-import { spawn } from "child_process";
-import { createInterface } from "readline";
-import { dirname, join } from "path";
-import { fileURLToPath } from "url";
-import { ConsoleBuffer } from "./session";
-import { pickExistingPath } from "./bridge-path";
-const BRIDGE_REQUEST_TIMEOUT_MS = 30000;
-function bridgeScriptPath() {
-    // Resolve the bridge script for BOTH layouts (rule #12 — read from disk):
-    //   src/modules/browser/bridge-server.mjs          (bun run src/…)
-    //   dist/modules/browser/bridge-server.mjs         (bundle at dist/main.js +
-    //                                                   assets copied by copy-assets.ts)
-    // The single-candidate version looked next to the bundle (dist/bridge-server.mjs),
-    // which copy-assets.ts never produces — so the browser tool died with ENOENT
-    // in the released npm package (observed: 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);
-}
-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,
-            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; // stale child — a newer bridge is alive
-            this.failPending(`Bridge process failed to start: ${err.message}`);
-            this.proc = null;
-            this.rl = null;
-        });
-        proc.on("exit", (code) => {
-            if (this.proc !== proc)
-                return; // stale child — a newer bridge is alive
-            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 {
-            // ignore — we're shutting down
-        }
-        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 @@
-import { existsSync } from "fs";
-/**
- * Pick the first existing candidate path, falling back to the first candidate.
- * Split out of bridge-client.ts so the source-vs-dist layout resolution is
- * unit-testable without spawning a node bridge (rule #12: build-time values
- * are resolved from disk at runtime, never inlined).
- */
-export function pickExistingPath(candidates, fallback = candidates[0]) {
-    return candidates.find((p) => existsSync(p)) ?? fallback;
-}

package/dist/modules/browser/driver.js

@@ -1,136 +0,0 @@
-import { chromium } from "playwright";
-import { ConsoleBuffer } from "./session";
-export const DIRECT_LAUNCH_TIMEOUT_MS = 8000;
-export class PlaywrightDriver {
-    browser = null;
-    context = null;
-    page = null;
-    console = new ConsoleBuffer();
-    network = [];
-    async launch(cfg) {
-        if (this.browser)
-            return;
-        this.browser = await chromium.launch({
-            headless: cfg.headless,
-            timeout: cfg.timeoutMs,
-        });
-        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;
-    }
-}
-export function createBrowserDriver(config) {
-    const common = {
-        headless: config.headless,
-        viewport: { width: config.viewportWidth, height: config.viewportHeight },
-        timeoutMs: config.navigationTimeout,
-    };
-    return (async () => {
-        // Playwright's pipe/websocket transport is broken under Bun on some
-        // platforms (see oven-sh/bun#31105, #9911). Under Bun we always use the
-        // Node bridge. Under Node we try the direct path first.
-        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;
-}