micro-models-agent 0.41.0 → 0.41.2

package/bin/mma.mjs

@@ -1,41 +1,41 @@
-#!/usr/bin/env node
-import { spawnSync } from "node:child_process";
-import { fileURLToPath, pathToFileURL } from "node:url";
-import { dirname, join } from "node:path";
-
-// MMA is designed to run under Bun: clipboard image paste relies on
-// `Bun.Image.fromClipboard()` (Node has no clipboard API), and on Windows a
-// bare `npx.cmd` shim can only be spawned reliably through Bun's child_process
-// (under Node it throws `spawn EINVAL`). The global npm shim (`mma` /
-// `mma.cmd`) launches this file under Node, so re-execute ourselves under Bun
-// when it is available. The `bun run mma` path already runs under Bun and
-// skips the respawn.
-const runningUnderBun =
-	typeof globalThis.Bun !== "undefined" &&
-	typeof globalThis.Bun?.version !== "undefined";
-
-if (process.env.MMA_DEBUG_RUNTIME) {
-	console.error(
-		"[mma] runtime=" +
-			(runningUnderBun ? "bun " + globalThis.Bun.version : "node " + process.version),
-	);
-}
-
-if (!runningUnderBun) {
-	try {
-		const res = spawnSync("bun", [process.argv[1], ...process.argv.slice(2)], {
-			stdio: "inherit",
-			windowsHide: true,
-		});
-		if (res.error) throw res.error;
-		process.exit(res.status ?? 0);
-	} catch {
-		// `bun` is not on PATH — fall back to the Node import path (clipboard
-		// paste and LSP will degrade, but the agent still works).
-	}
-}
-
-const __dirname = dirname(fileURLToPath(import.meta.url));
-const main = join(__dirname, "..", "dist", "main.js");
-
-await import(pathToFileURL(main).href);
+#!/usr/bin/env node
+import { spawnSync } from "node:child_process";
+import { fileURLToPath, pathToFileURL } from "node:url";
+import { dirname, join } from "node:path";
+
+// MMA is designed to run under Bun: clipboard image paste relies on
+// `Bun.Image.fromClipboard()` (Node has no clipboard API), and on Windows a
+// bare `npx.cmd` shim can only be spawned reliably through Bun's child_process
+// (under Node it throws `spawn EINVAL`). The global npm shim (`mma` /
+// `mma.cmd`) launches this file under Node, so re-execute ourselves under Bun
+// when it is available. The `bun run mma` path already runs under Bun and
+// skips the respawn.
+const runningUnderBun =
+	typeof globalThis.Bun !== "undefined" &&
+	typeof globalThis.Bun?.version !== "undefined";
+
+if (process.env.MMA_DEBUG_RUNTIME) {
+	console.error(
+		"[mma] runtime=" +
+			(runningUnderBun ? "bun " + globalThis.Bun.version : "node " + process.version),
+	);
+}
+
+if (!runningUnderBun) {
+	try {
+		const res = spawnSync("bun", [process.argv[1], ...process.argv.slice(2)], {
+			stdio: "inherit",
+			windowsHide: true,
+		});
+		if (res.error) throw res.error;
+		process.exit(res.status ?? 0);
+	} catch {
+		// `bun` is not on PATH — fall back to the Node import path (clipboard
+		// paste and LSP will degrade, but the agent still works).
+	}
+}
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const main = join(__dirname, "..", "dist", "main.js");
+
+await import(pathToFileURL(main).href);

package/dist/cli/commands.js

@@ -7,13 +7,11 @@ import { join, dirname } from "path";
 import { homedir } from "os";
 import { existsSync, readFileSync } from "fs";
 import { createSecurityCommand } from "./security-commands";
+import { createPluginCommand } from "./plugin-commands";
 import { fileURLToPath } from "url";
 function readVersion() {
     const here = dirname(fileURLToPath(import.meta.url));
-    const candidates = [
-        join(here, "..", "..", "package.json"),
-        join(here, "..", "package.json"),
-    ];
+    const candidates = [join(here, "..", "..", "package.json"), join(here, "..", "package.json")];
     for (const p of candidates) {
         if (existsSync(p)) {
             try {
@@ -55,9 +53,7 @@ export function createProgram() {
         // Apply security settings from wizard
         if (config.security) {
             config.security.enabled =
-                answers.securityBashBlock ||
-                    answers.securityFlagsBlock ||
-                    !answers.securityPathsDeny;
+                answers.securityBashBlock || answers.securityFlagsBlock || !answers.securityPathsDeny;
             config.security.bash.enabled = config.security.enabled;
             config.security.bash.blockDangerousFlags = answers.securityFlagsBlock;
             if (answers.securityBashBlock) {
@@ -90,9 +86,7 @@ export function createProgram() {
         saveConfig(config, configPath);
         console.log(t("cli.config_saved"));
     });
-    const configCmd = program
-        .command("config")
-        .description(t("cli.manage_config"));
+    const configCmd = program.command("config").description(t("cli.manage_config"));
     configCmd
         .command("set")
         .argument("<key>", t("cli.config_key"))
@@ -199,9 +193,7 @@ export function createProgram() {
             name,
             providerUrl: cmdOpts.providerUrl,
             providerKey: cmdOpts.providerKey,
-            contextWindow: cmdOpts.contextWindow
-                ? parseInt(cmdOpts.contextWindow, 10)
-                : undefined,
+            contextWindow: cmdOpts.contextWindow ? parseInt(cmdOpts.contextWindow, 10) : undefined,
             tags: parseTags(cmdOpts.tags),
             reps: cmdOpts.reps ? parseInt(cmdOpts.reps, 10) : 3,
             force: cmdOpts.force === true,
@@ -251,9 +243,7 @@ export function createProgram() {
         saveConfig(config, configPath);
         console.log(t("cli.context_set", { size: contextWindow }));
     });
-    const provider = program
-        .command("provider")
-        .description(t("cli.manage_providers"));
+    const provider = program.command("provider").description(t("cli.manage_providers"));
     provider
         .command("list")
         .description(t("cli.list_providers"))
@@ -273,9 +263,7 @@ export function createProgram() {
         saveConfig(config, configPath);
         console.log(t("cli.provider_set", { name }));
     });
-    const session = program
-        .command("session")
-        .description(t("cli.manage_sessions"));
+    const session = program.command("session").description(t("cli.manage_sessions"));
     session
         .command("list")
         .description(t("cli.list_sessions"))
@@ -323,6 +311,8 @@ export function createProgram() {
     });
     // Add security commands
     createSecurityCommand(program);
+    // Add plugin commands
+    createPluginCommand(program);
     program
         .argument("[prompt...]", "Prompt to execute")
         .description("Run a single prompt")

package/dist/cli/completer.js

@@ -1,22 +1,20 @@
-import { readdirSync, statSync } from 'fs';
-import { join } from 'path';
+import { readdirSync, statSync } from "fs";
+import { join } from "path";
 export class SlashCommandProvider {
-    name = 'slash-commands';
+    name = "slash-commands";
     commands;
     constructor(commands) {
         this.commands = commands;
     }
     match(ctx) {
-        return ctx.tokenIndex === 0 && ctx.line.startsWith('/');
+        return ctx.tokenIndex === 0 && ctx.line.startsWith("/");
     }
     complete(ctx) {
-        return this.commands
-            .filter(c => c.startsWith(ctx.partial.slice(1)))
-            .map(c => `/${c}`);
+        return this.commands.filter((c) => c.startsWith(ctx.partial.slice(1))).map((c) => `/${c}`);
     }
 }
 export class SubcommandProvider {
-    name = 'subcommands';
+    name = "subcommands";
     command;
     subcommands;
     constructor(command, subcommands) {
@@ -27,54 +25,54 @@ export class SubcommandProvider {
         return ctx.tokenIndex === 1 && ctx.tokens[0] === `/${this.command}`;
     }
     complete(ctx) {
-        return this.subcommands.filter(s => s.startsWith(ctx.partial));
+        return this.subcommands.filter((s) => s.startsWith(ctx.partial));
     }
 }
 export class ModelArgProvider {
-    name = 'model-args';
+    name = "model-args";
     models;
     constructor(models) {
         this.models = models;
     }
     match(ctx) {
-        return ctx.tokenIndex === 2 && (ctx.tokens[0] === '/model' || ctx.tokens[0] === '/config');
+        return ctx.tokenIndex === 2 && (ctx.tokens[0] === "/model" || ctx.tokens[0] === "/config");
     }
     complete(ctx) {
-        return this.models.filter(m => m.startsWith(ctx.partial));
+        return this.models.filter((m) => m.startsWith(ctx.partial));
     }
 }
 export class ConfigKeyProvider {
-    name = 'config-keys';
+    name = "config-keys";
     keys;
     constructor(keys) {
         this.keys = keys;
     }
     match(ctx) {
-        return ctx.tokenIndex >= 1 && ctx.tokens[0] === '/config' && ctx.tokens[1] === 'set';
+        return ctx.tokenIndex >= 1 && ctx.tokens[0] === "/config" && ctx.tokens[1] === "set";
     }
     complete(ctx) {
-        return this.keys.filter(k => k.startsWith(ctx.partial));
+        return this.keys.filter((k) => k.startsWith(ctx.partial));
     }
 }
 export class FilePathProvider {
-    name = 'file-paths';
+    name = "file-paths";
     match(ctx) {
-        return ctx.partial.includes('/') || ctx.partial.includes('\\');
+        return ctx.partial.includes("/") || ctx.partial.includes("\\");
     }
     complete(ctx) {
         try {
             const cwd = process.cwd();
             const partialPath = ctx.partial;
-            const lastSlash = Math.max(partialPath.lastIndexOf('/'), partialPath.lastIndexOf('\\'));
-            const dirPath = lastSlash > 0 ? partialPath.slice(0, lastSlash) : '.';
-            const prefix = lastSlash > 0 ? partialPath.slice(0, lastSlash + 1) : '';
+            const lastSlash = Math.max(partialPath.lastIndexOf("/"), partialPath.lastIndexOf("\\"));
+            const dirPath = lastSlash > 0 ? partialPath.slice(0, lastSlash) : ".";
+            const prefix = lastSlash > 0 ? partialPath.slice(0, lastSlash + 1) : "";
             const fullPath = join(cwd, dirPath);
             const entries = readdirSync(fullPath);
             const matches = [];
             for (const entry of entries) {
                 const entryPath = join(fullPath, entry);
                 const stat = statSync(entryPath);
-                const completion = prefix + entry + (stat.isDirectory() ? '/' : '');
+                const completion = prefix + entry + (stat.isDirectory() ? "/" : "");
                 if (completion.startsWith(ctx.partial)) {
                     matches.push(completion);
                 }
@@ -87,59 +85,60 @@ export class FilePathProvider {
     }
 }
 export class ProviderArgProvider {
-    name = 'provider-args';
+    name = "provider-args";
     providers;
     constructor(providers) {
         this.providers = providers;
     }
     match(ctx) {
-        return ctx.tokenIndex === 2 && ctx.tokens[0] === '/provider' && ctx.tokens[1] === 'use';
+        return ctx.tokenIndex === 2 && ctx.tokens[0] === "/provider" && ctx.tokens[1] === "use";
     }
     complete(ctx) {
-        return this.providers.filter(p => p.startsWith(ctx.partial));
+        return this.providers.filter((p) => p.startsWith(ctx.partial));
     }
 }
 export class SessionNameProvider {
-    name = 'session-names';
+    name = "session-names";
     getNames;
     constructor(getNames) {
         this.getNames = getNames;
     }
     match(ctx) {
-        return ctx.tokenIndex >= 1 && ctx.tokens[0] === '/resume';
+        return ctx.tokenIndex >= 1 && ctx.tokens[0] === "/resume";
     }
     complete(ctx) {
         const names = this.getNames();
         if (!ctx.partial)
             return names;
-        return names.filter(n => n.toLowerCase().includes(ctx.partial.toLowerCase()));
+        return names.filter((n) => n.toLowerCase().includes(ctx.partial.toLowerCase()));
     }
 }
 export class SkillNameProvider {
-    name = 'skill-names';
+    name = "skill-names";
     skillsModule;
     constructor(skillsModule) {
         this.skillsModule = skillsModule;
     }
     match(ctx) {
-        return ctx.tokenIndex >= 2 && ctx.tokens[0] === '/skill' &&
-            (ctx.tokens[1] === 'load' || ctx.tokens[1] === 'unload');
+        return (ctx.tokenIndex >= 2 &&
+            ctx.tokens[0] === "/skill" &&
+            (ctx.tokens[1] === "load" || ctx.tokens[1] === "unload"));
     }
     complete(ctx) {
         const subcmd = ctx.tokens[1];
-        if (subcmd === 'load') {
+        if (subcmd === "load") {
             const available = this.skillsModule.getAvailable();
-            const names = available.map(s => s.name);
+            const names = available.map((s) => s.name);
             if (!ctx.partial)
                 return names;
-            return names.filter(n => n.toLowerCase().includes(ctx.partial.toLowerCase()));
+            return names.filter((n) => n.toLowerCase().includes(ctx.partial.toLowerCase()));
         }
-        if (subcmd === 'unload') {
+        if (subcmd === "unload") {
             const loaded = this.skillsModule.getLoaded();
-            const names = loaded.map(s => s.name);
+            const names = loaded.map((s) => s.name);
             if (!ctx.partial)
                 return names;
-            return names.filter(n => n.toLowerCase().includes(ctx.partial.toLowerCase()));
+            return names.filter((n) => n.toLowerCase().includes(ctx.partial.toLowerCase()));
         }
         return [];
     }
@@ -152,7 +151,7 @@ export class Completer {
     complete(line) {
         const cursor = line.length;
         const tokens = line.split(/\s+/);
-        const partial = tokens[tokens.length - 1] || '';
+        const partial = tokens[tokens.length - 1] || "";
         const tokenIndex = tokens.length - 1;
         const ctx = { line, cursor, tokens, partial, tokenIndex };
         for (const provider of this.providers) {

package/dist/cli/index.js

@@ -1,2 +1,2 @@
-export { main } from './main';
-export { createProgram } from './commands';
+export { main } from "./main";
+export { createProgram } from "./commands";

package/dist/cli/main.js

@@ -1,15 +1,50 @@
 import { createProgram } from "./commands";
 import { bootstrap } from "../core/bootstrap";
 import { Repl } from "./repl";
-import { formatMarkdown } from "../ui/md-formatter";
 import { Renderer } from "../ui/renderer";
+import { printRunResult } from "./run-result";
 import { runSetup } from "./setup";
 import { saveConfig, loadConfig } from "../config/config";
 import { t } from "../i18n/index";
 import { pc } from "../ui/colors";
-import { existsSync } from "fs";
-import { join } from "path";
+import { existsSync, readFileSync } from "fs";
+import { join, dirname } from "path";
 import { homedir } from "os";
+import { fileURLToPath } from "url";
+import { UpdaterModule } from "../modules/updater/index";
+function readVersion() {
+    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 {
+                // fall through
+            }
+        }
+    }
+    return "0.0.0";
+}
+/** Fire-and-forget self-update in the background (never blocks startup). */
+function startAutoUpdate(config) {
+    try {
+        const module = new UpdaterModule(config.updater, readVersion(), "micro-models-agent", {
+            info: (m) => process.stderr.write(pc.dim(m) + "\n"),
+            warn: (m) => process.stderr.write(pc.yellow(m) + "\n"),
+            error: (m) => process.stderr.write(pc.red(m) + "\n"),
+        });
+        module.start();
+        return module;
+    }
+    catch {
+        // Auto-update is best-effort; never let it crash startup.
+        return undefined;
+    }
+}
 async function main() {
     const program = createProgram();
     program.parse(process.argv);
@@ -26,6 +61,7 @@ async function main() {
     if (program.args.length > 0) {
         const prompt = program.args.join(" ");
         const { agent, config } = await bootstrap(undefined, projectDir, noAgentsMd, exitOnComplete);
+        const updater = exitOnComplete ? undefined : startAutoUpdate(config);
         if (jsonMode) {
             const result = await agent.run(prompt);
             agent.shutdown();
@@ -41,6 +77,7 @@ async function main() {
                 totalTokens: result.totalTokens ?? null,
             }, null, 2));
             process.stdout.write("\n");
+            await updater?.waitForIdle();
             process.exit(result.success ? 0 : 1);
         }
         const renderer = new Renderer({
@@ -63,19 +100,10 @@ async function main() {
             }
         });
         renderer.flush();
-        if (result.success) {
-            if (!result.text) {
-                console.log(pc.yellow(t("cli.no_output")));
-            }
-        }
-        else {
-            console.error(`${t("error.prefix")}${result.error}`);
-            if (result.text) {
-                console.log(formatMarkdown(result.text));
-            }
-            process.exit(1);
-        }
+        const exitCode = printRunResult(result, () => renderer.flush());
         agent.shutdown();
+        await updater?.waitForIdle();
+        process.exit(exitCode);
     }
     else {
         const configPath = join(homedir(), ".mma", "config.json");
@@ -84,9 +112,7 @@ async function main() {
             const answers = await runSetup();
             const config = loadConfig({
                 configDir: join(homedir(), ".mma"),
-                projectConfigPath: projectDir
-                    ? join(projectDir, ".mmrc")
-                    : join(process.cwd(), ".mmrc"),
+                projectConfigPath: projectDir ? join(projectDir, ".mmrc") : join(process.cwd(), ".mmrc"),
             });
             config.provider.type = answers.provider;
             config.provider.baseUrl = answers.apiBase;
@@ -97,9 +123,7 @@ async function main() {
             config.locale = answers.locale;
             if (config.security) {
                 config.security.enabled =
-                    answers.securityBashBlock ||
-                        answers.securityFlagsBlock ||
-                        !answers.securityPathsDeny;
+                    answers.securityBashBlock || answers.securityFlagsBlock || !answers.securityPathsDeny;
                 config.security.bash.enabled = config.security.enabled;
                 config.security.bash.blockDangerousFlags = answers.securityFlagsBlock;
                 if (answers.securityBashBlock) {
@@ -132,8 +156,9 @@ async function main() {
             saveConfig(config, configPath);
         }
         const { agent, config, sessionManager, skillsModule, pluginManager, configDir, baseDir, logger, } = await bootstrap(undefined, projectDir, noAgentsMd, exitOnComplete);
-        const repl = new Repl(agent, config, sessionManager, skillsModule, pluginManager, configDir, baseDir, noAgentsMd, logger);
-        repl.start();
+        startAutoUpdate(config);
+        const repl = new Repl(agent, config, sessionManager, skillsModule, pluginManager, configDir, baseDir, noAgentsMd, logger, true);
+        await repl.start();
     }
 }
 main();

package/dist/cli/plugin-commands.js

@@ -0,0 +1,36 @@
+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/repl-commands.js

@@ -10,10 +10,7 @@ import { existsSync, readFileSync } from "fs";
 import { fileURLToPath } from "url";
 function readVersion() {
     const here = dirname(fileURLToPath(import.meta.url));
-    const candidates = [
-        join(here, "..", "..", "package.json"),
-        join(here, "..", "package.json"),
-    ];
+    const candidates = [join(here, "..", "..", "package.json"), join(here, "..", "package.json")];
     for (const p of candidates) {
         if (existsSync(p)) {
             try {
@@ -50,6 +47,7 @@ export const COMMAND_GROUPS = {
     rename: "session",
     delete: "session",
     skill: "skill",
+    plugins: "agent",
 };
 export function registerAllCommands(ctx) {
     registerBuiltinCommands(ctx);
@@ -122,8 +120,7 @@ function registerMmaCommands(ctx) {
                     dataUrl = result.dataUrl;
                     label = "clipboard";
                 }
-                else if (source.startsWith("http://") ||
-                    source.startsWith("https://")) {
+                else if (source.startsWith("http://") || source.startsWith("https://")) {
                     const result = await loadUrlAsDataUrl(source);
                     dataUrl = result.dataUrl;
                     label = source;
@@ -184,9 +181,7 @@ function registerMmaCommands(ctx) {
         usage: t("repl.reasoning_usage"),
         action: () => {
             ctx.config.showReasoning = !ctx.config.showReasoning;
-            const status = ctx.config.showReasoning
-                ? pc.green(t("repl.show"))
-                : pc.dim(t("repl.hide"));
+            const status = ctx.config.showReasoning ? pc.green(t("repl.show")) : pc.dim(t("repl.hide"));
             console.log(t("repl.reasoning_status", { status }));
         },
     });
@@ -391,6 +386,41 @@ function registerMmaCommands(ctx) {
             console.log(`${t("repl.provider")}    ${ctx.config.provider.type} @ ${ctx.config.provider.baseUrl}`);
         },
     });
+    ctx.registerCommand({
+        name: "plugins",
+        description: t("repl.plugins"),
+        usage: t("repl.plugins_usage"),
+        action: (args) => {
+            if (!ctx.pluginManager) {
+                console.log(t("cli.plugins.none"));
+                return;
+            }
+            const showAll = args.includes("--all");
+            const infos = ctx.pluginManager.getPluginInfos();
+            const filtered = showAll ? infos : infos.filter(({ plugin }) => !plugin.isBuiltin);
+            if (filtered.length === 0) {
+                console.log(t("cli.plugins.none"));
+                return;
+            }
+            const mmaVersion = version;
+            console.log(t("cli.plugins.header", {
+                count: String(filtered.length),
+                mma: mmaVersion,
+            }));
+            for (const { plugin, source } of filtered) {
+                const v = plugin.version || "-";
+                const origin = source || "builtin";
+                const mark = plugin.isBuiltin ? t("cli.plugins.builtin_mark") : " ";
+                console.log(`  ${mark} ${plugin.name}  v${v}  [${origin}]`);
+            }
+            if (!showAll) {
+                const builtinCount = infos.filter(({ plugin }) => plugin.isBuiltin).length;
+                if (builtinCount > 0) {
+                    console.log(pc.dim(`  (${builtinCount} builtin hidden — /plugins --all to show)`));
+                }
+            }
+        },
+    });
 }
 function registerSessionCommands(ctx) {
     if (!ctx.sessionManager)
@@ -559,9 +589,7 @@ function registerSkillCommands(ctx) {
                 console.log(pc.bold(t("repl.available_skills")));
                 for (const skill of available) {
                     const tokens = Math.ceil(skill.content.length / 4);
-                    const loaded = ctx
-                        .skillsModule.getLoaded()
-                        .some((s) => s.name === skill.name);
+                    const loaded = ctx.skillsModule.getLoaded().some((s) => s.name === skill.name);
                     const marker = loaded ? pc.green(" [loaded]") : "";
                     console.log(`  ${pc.cyan(skill.name)}${marker}  ${pc.dim(`(${tokens} tokens)`)}  ${skill.description.slice(0, 60)}`);
                 }