micro-models-agent 0.62.0 → 0.63.0

package/CHANGELOG.md

@@ -4,6 +4,14 @@ All notable changes to Micro Models Agent (MMA) will be documented in this file.
 
 The format is based on [Keep a Changelog](https://keepachangelog.com/), and this project adheres to [Semantic Versioning](https://semver.org/).
 
+## [0.63.0] - 2026-09-17
+
+### Added
+- **REPL `/provider add`**: add a provider without leaving the agent. Mirrors `mma provider add` — `/provider add <name> [--url <url>] [--key <key>] [--priority <n>] [--context-window <n>] [--rpm <n>] [--parallel <n>]`. Seeds the legacy provider into `provider.entries` on first use, saves the config and hot-reloads the agent; switch with `/provider use <name>`. `/provider` autocompletion now includes `add`; i18n `repl.provider_add_missing_value`, `repl.provider_switch_hint` (en+ru).
+
+### Changed
+- **Subcommand dispatch via handler maps** (new architecture rule #17): `/provider`, `/model` and `/skill` (`src/cli/repl-commands.ts`) and `SkillNameProvider.complete` (`src/cli/completer.ts`) now resolve subcommands through a `Record<string, handler>` map instead of `if (subcmd === …)` chains.
+
 ## [0.62.0] - 2026-09-17
 
 ### Added

package/dist/i18n/en.json

@@ -494,7 +494,9 @@
   "repl.provider_list": "List configured providers or hot-swap the active one",
   "repl.provider_current": "Current provider",
   "repl.provider_set": "Provider set to: {name}",
-  "repl.provider_usage": "/provider list - show entries (* = active, prio = fallback order) | /provider use <name> - switch without restart",
+  "repl.provider_usage": "/provider list - show entries (* = active, prio = fallback order) | /provider use <name> - switch without restart | /provider add <name> [--url <url>] [--key <key>] [--priority <n>] [--context-window <n>] [--rpm <n>] [--parallel <n>] - add to config",
+  "repl.provider_add_missing_value": "Missing value for {flag}",
+  "repl.provider_switch_hint": "Switch to it with: /provider use {name}",
   "repl.model_list": "List models of the active provider or switch the model",
   "repl.model_current": "Current model",
   "repl.model_set": "Model set to: {name}",

package/dist/i18n/ru.json

@@ -488,7 +488,9 @@
   "repl.provider_list": "Список настроенных провайдеров или горячая смена активного",
   "repl.provider_current": "Текущий провайдер",
   "repl.provider_set": "Провайдер установлен: {name}",
-  "repl.provider_usage": "/provider list — записи (* = активный, prio = порядок fallback) | /provider use <имя> — смена без перезапуска",
+  "repl.provider_usage": "/provider list — записи (* = активный, prio = порядок fallback) | /provider use <имя> — смена без перезапуска | /provider add <имя> [--url <url>] [--key <ключ>] [--priority <n>] [--context-window <n>] [--rpm <n>] [--parallel <n>] — добавить в конфиг",
+  "repl.provider_add_missing_value": "Нет значения для {flag}",
+  "repl.provider_switch_hint": "Переключитесь на него: /provider use {name}",
   "repl.model_list": "Список моделей активного провайдера или смена модели",
   "repl.model_current": "Текущая модель",
   "repl.model_set": "Модель установлена: {name}",

package/dist/main.js

@@ -2945,7 +2945,9 @@ Excluded blocks: {count}`,
     "repl.provider_list": "List configured providers or hot-swap the active one",
     "repl.provider_current": "Current provider",
     "repl.provider_set": "Provider set to: {name}",
-    "repl.provider_usage": "/provider list - show entries (* = active, prio = fallback order) | /provider use <name> - switch without restart",
+    "repl.provider_usage": "/provider list - show entries (* = active, prio = fallback order) | /provider use <name> - switch without restart | /provider add <name> [--url <url>] [--key <key>] [--priority <n>] [--context-window <n>] [--rpm <n>] [--parallel <n>] - add to config",
+    "repl.provider_add_missing_value": "Missing value for {flag}",
+    "repl.provider_switch_hint": "Switch to it with: /provider use {name}",
     "repl.model_list": "List models of the active provider or switch the model",
     "repl.model_current": "Current model",
     "repl.model_set": "Model set to: {name}",
@@ -3774,7 +3776,9 @@ var init_ru = __esm(() => {
     "repl.provider_list": "Список настроенных провайдеров или горячая смена активного",
     "repl.provider_current": "Текущий провайдер",
     "repl.provider_set": "Провайдер установлен: {name}",
-    "repl.provider_usage": "/provider list — записи (* = активный, prio = порядок fallback) | /provider use <имя> — смена без перезапуска",
+    "repl.provider_usage": "/provider list — записи (* = активный, prio = порядок fallback) | /provider use <имя> — смена без перезапуска | /provider add <имя> [--url <url>] [--key <ключ>] [--priority <n>] [--context-window <n>] [--rpm <n>] [--parallel <n>] — добавить в конфиг",
+    "repl.provider_add_missing_value": "Нет значения для {flag}",
+    "repl.provider_switch_hint": "Переключитесь на него: /provider use {name}",
     "repl.model_list": "Список моделей активного провайдера или смена модели",
     "repl.model_current": "Текущая модель",
     "repl.model_set": "Модель установлена: {name}",
@@ -36705,100 +36709,172 @@ function registerConfigCommands(ctx) {
   });
 }
 function registerProviderCommands(ctx) {
+  const list = () => {
+    const providers = ctx.agent.listProviders();
+    if (providers.length === 0) {
+      console.log(`${t("repl.provider_current")}  ${ctx.config.provider.type}`);
+      console.log(`  ${ctx.config.provider.baseUrl}`);
+      return;
+    }
+    console.log(t("repl.provider_current"));
+    for (const p of providers) {
+      const marker = p.active ? pc2.green("* ") : "  ";
+      console.log(` ${marker}${p.label}  (${pc2.dim(p.type)})  ${pc2.dim(p.baseUrl)}`);
+    }
+  };
+  const use = async (args) => {
+    const name = args[0];
+    if (!name) {
+      console.log(t("repl.provider_usage"));
+      return;
+    }
+    try {
+      await ctx.agent.setProvider(name);
+      ctx.refreshModelCache();
+      console.log(pc2.green(t("repl.provider_set", { name })));
+    } catch (e) {
+      console.log(pc2.red(e.message));
+    }
+  };
+  const add = async (args) => {
+    const flags = {};
+    let name;
+    for (let i = 0;i < args.length; i++) {
+      const arg = args[i];
+      if (arg.startsWith("--")) {
+        const value = args[i + 1];
+        if (value === undefined || value.startsWith("--")) {
+          console.log(pc2.red(t("repl.provider_add_missing_value", { flag: arg })));
+          return;
+        }
+        flags[arg.slice(2)] = value;
+        i++;
+      } else if (name === undefined) {
+        name = arg;
+      }
+    }
+    if (!name) {
+      console.log(t("repl.provider_usage"));
+      return;
+    }
+    const entries = Array.isArray(ctx.config.provider.entries) ? ctx.config.provider.entries : [];
+    if (entries.length === 0) {
+      entries.push({
+        type: ctx.config.provider.type,
+        label: ctx.config.provider.type,
+        baseUrl: ctx.config.provider.baseUrl,
+        apiKey: ctx.config.provider.apiKey
+      });
+    }
+    const baseUrl = flags.url || HOSTED_BASE_URLS[name] || HOSTED_BASE_URLS[`opencode-${name}`] || "";
+    if (!baseUrl) {
+      console.log(pc2.red(t("cli.provider_no_url", { name })));
+      return;
+    }
+    entries.push({
+      type: name,
+      label: name,
+      baseUrl,
+      apiKey: flags.key,
+      ...flags.priority !== undefined ? { priority: Number(flags.priority) } : {},
+      ...flags["context-window"] !== undefined ? { contextWindow: Number(flags["context-window"]) } : {},
+      ...flags.rpm !== undefined || flags.parallel !== undefined ? {
+        rateLimits: {
+          maxRequestsPerMinute: Number(flags.rpm ?? 0) || 60,
+          maxParallelTasks: Number(flags.parallel ?? 0) || 1
+        }
+      } : {}
+    });
+    ctx.config.provider.entries = entries;
+    ctx.config.provider.active = ctx.config.provider.active || ctx.config.provider.type;
+    const configPath = join54(ctx.configDir, "config.json");
+    saveConfig(ctx.config, configPath, dirname24(configPath));
+    await ctx.agent.reconfigure(ctx.config);
+    console.log(pc2.green(t("cli.provider_added", { name })));
+    console.log(t("repl.provider_switch_hint", { name }));
+  };
+  const handlers = {
+    list,
+    use,
+    add
+  };
   ctx.registerCommand({
     name: "provider",
     description: t("repl.provider_list"),
     usage: t("repl.provider_usage"),
     action: async (args) => {
       const subcmd = args[0];
-      if (!subcmd || subcmd === "list") {
-        const providers = ctx.agent.listProviders();
-        if (providers.length === 0) {
-          console.log(`${t("repl.provider_current")}  ${ctx.config.provider.type}`);
-          console.log(`  ${ctx.config.provider.baseUrl}`);
-        } else {
-          console.log(t("repl.provider_current"));
-          for (const p of providers) {
-            const marker = p.active ? pc2.green("* ") : "  ";
-            console.log(` ${marker}${p.label}  (${pc2.dim(p.type)})  ${pc2.dim(p.baseUrl)}`);
-          }
-        }
+      const handler = subcmd ? handlers[subcmd] : handlers.list;
+      if (!handler) {
+        console.log(t("repl.provider_usage"));
         return;
       }
-      if (subcmd === "use") {
-        const name = args[1];
-        if (!name) {
-          console.log(t("repl.provider_usage"));
-          return;
-        }
-        try {
-          await ctx.agent.setProvider(name);
-          ctx.refreshModelCache();
-          console.log(pc2.green(t("repl.provider_set", { name })));
-        } catch (e) {
-          console.log(pc2.red(e.message));
+      await handler(args.slice(1));
+    }
+  });
+  const listModels = async () => {
+    console.log(`${t("repl.model_current")}  ${ctx.config.model}`);
+    const { OpenAICompatProvider: OpenAICompatProvider2 } = await Promise.resolve().then(() => (init_openai_compat(), exports_openai_compat));
+    const provider = new OpenAICompatProvider2({
+      model: ctx.config.model,
+      baseUrl: ctx.config.provider.baseUrl,
+      apiKey: ctx.config.provider.apiKey,
+      contextWindow: ctx.config.contextWindow
+    });
+    const { Spinner: Spinner2 } = await Promise.resolve().then(() => (init_spinner(), exports_spinner));
+    const s = new Spinner2;
+    s.start(t("cli.fetching_models"));
+    try {
+      const models = await provider.listModels();
+      s.stop();
+      if (models.length > 0) {
+        ctx.refreshModelCache();
+        console.log(t("cli.available_models"));
+        const { getCertMark: getCertMark2 } = await Promise.resolve().then(() => (init_manifest(), exports_manifest));
+        for (const m of models) {
+          const marker = m === ctx.config.model ? pc2.green("* ") : "  ";
+          const mark = getCertMark2(m, ctx.config.provider.baseUrl, version2, process.cwd());
+          const cert = mark === "certified" ? pc2.green("✔") : mark === "stale" ? pc2.yellow("○") : pc2.dim("·");
+          const label = mark === "certified" ? `  ${pc2.green(t("cli.cert_label"))}` : mark === "stale" ? `  ${pc2.yellow(t("cli.cert_stale_label"))}` : "";
+          console.log(` ${marker}${cert} ${m}${label}`);
         }
-        return;
+      } else {
+        console.log(t("cli.no_models_found"));
       }
-      console.log(t("repl.provider_usage"));
+    } catch (err) {
+      s.stop();
+      console.log(t("cli.model_fetch_failed", { error: String(err) }));
     }
-  });
+    console.log(t("cli.model_hint"));
+  };
+  const useModel = async (args) => {
+    const name = args[0];
+    if (!name) {
+      console.log(t("repl.model_usage"));
+      return;
+    }
+    ctx.config.model = name;
+    const configPath = join54(ctx.configDir, "config.json");
+    saveConfig(ctx.config, configPath, dirname24(configPath));
+    await ctx.agent.reconfigure(ctx.config);
+    console.log(pc2.green(t("repl.model_set", { name })));
+  };
+  const modelHandlers = {
+    list: listModels,
+    use: useModel
+  };
   ctx.registerCommand({
     name: "model",
     description: t("repl.model_list"),
     usage: t("repl.model_usage"),
     action: async (args) => {
       const subcmd = args[0];
-      if (!subcmd || subcmd === "list") {
-        console.log(`${t("repl.model_current")}  ${ctx.config.model}`);
-        const { OpenAICompatProvider: OpenAICompatProvider2 } = await Promise.resolve().then(() => (init_openai_compat(), exports_openai_compat));
-        const provider = new OpenAICompatProvider2({
-          model: ctx.config.model,
-          baseUrl: ctx.config.provider.baseUrl,
-          apiKey: ctx.config.provider.apiKey,
-          contextWindow: ctx.config.contextWindow
-        });
-        const { Spinner: Spinner2 } = await Promise.resolve().then(() => (init_spinner(), exports_spinner));
-        const s = new Spinner2;
-        s.start(t("cli.fetching_models"));
-        try {
-          const models = await provider.listModels();
-          s.stop();
-          if (models.length > 0) {
-            ctx.refreshModelCache();
-            console.log(t("cli.available_models"));
-            const { getCertMark: getCertMark2 } = await Promise.resolve().then(() => (init_manifest(), exports_manifest));
-            for (const m of models) {
-              const marker = m === ctx.config.model ? pc2.green("* ") : "  ";
-              const mark = getCertMark2(m, ctx.config.provider.baseUrl, version2, process.cwd());
-              const cert = mark === "certified" ? pc2.green("✔") : mark === "stale" ? pc2.yellow("○") : pc2.dim("·");
-              const label = mark === "certified" ? `  ${pc2.green(t("cli.cert_label"))}` : mark === "stale" ? `  ${pc2.yellow(t("cli.cert_stale_label"))}` : "";
-              console.log(` ${marker}${cert} ${m}${label}`);
-            }
-          } else {
-            console.log(t("cli.no_models_found"));
-          }
-        } catch (err) {
-          s.stop();
-          console.log(t("cli.model_fetch_failed", { error: String(err) }));
-        }
-        console.log(t("cli.model_hint"));
-        return;
-      }
-      if (subcmd === "use") {
-        const name = args[1];
-        if (!name) {
-          console.log(t("repl.model_usage"));
-          return;
-        }
-        ctx.config.model = name;
-        const configPath = join54(ctx.configDir, "config.json");
-        saveConfig(ctx.config, configPath, dirname24(configPath));
-        await ctx.agent.reconfigure(ctx.config);
-        console.log(pc2.green(t("repl.model_set", { name })));
+      const handler = subcmd ? modelHandlers[subcmd] : modelHandlers.list;
+      if (!handler) {
+        console.log(t("repl.model_usage"));
         return;
       }
-      console.log(t("repl.model_usage"));
+      await handler(args.slice(1));
     }
   });
   ctx.registerCommand({
@@ -37107,88 +37183,97 @@ function registerSessionCommands(ctx) {
 function registerSkillCommands(ctx) {
   if (!ctx.skillsModule)
     return;
+  const listSkills = () => {
+    const available = ctx.skillsModule.getAvailable();
+    if (available.length === 0) {
+      console.log(t("repl.no_skills"));
+      return;
+    }
+    console.log(pc2.bold(t("repl.available_skills")));
+    for (const skill of available) {
+      const tokens = estimateTokens(skill.content);
+      const loaded = ctx.skillsModule.getLoaded().some((s) => s.name === skill.name);
+      const marker = loaded ? pc2.green(" [loaded]") : "";
+      console.log(`  ${pc2.cyan(skill.name)}${marker}  ${pc2.dim(`(${tokens} tokens)`)}  ${skill.description.slice(0, 60)}`);
+    }
+  };
+  const listLoaded = () => {
+    const loaded = ctx.skillsModule.getLoaded();
+    const budget = ctx.skillsModule.getBudget();
+    if (loaded.length === 0) {
+      console.log(t("repl.no_loaded"));
+      return;
+    }
+    console.log(pc2.bold(t("repl.loaded_skills")));
+    for (const skill of loaded) {
+      const tokens = estimateTokens(skill.content);
+      console.log(`  ${pc2.cyan(skill.name)}  ${pc2.dim(`(${tokens} tokens)`)}  ${skill.description.slice(0, 60)}`);
+    }
+    console.log(pc2.dim(`
+  ${t("repl.budget", { used: budget.used, total: budget.total, remaining: budget.remaining })}`));
+  };
+  const loadSkill = (args) => {
+    const arg = args.join(" ");
+    if (!arg) {
+      console.log(t("repl.skill_load_usage"));
+      return;
+    }
+    const result = ctx.skillsModule.loadByName(arg);
+    if (result.success) {
+      console.log(pc2.green(result.message));
+    } else {
+      console.log(pc2.red(result.message));
+    }
+  };
+  const unloadSkill = (args) => {
+    const arg = args.join(" ");
+    if (!arg) {
+      console.log(t("repl.skill_unload_usage"));
+      return;
+    }
+    if (ctx.skillsModule.unload(arg)) {
+      console.log(pc2.green(t("repl.skill_unloaded", { name: arg })));
+    } else {
+      console.log(pc2.red(t("repl.skill_not_loaded", { name: arg })));
+    }
+  };
+  const searchSkills = (args) => {
+    const arg = args.join(" ");
+    if (!arg) {
+      console.log(t("repl.skill_search_usage"));
+      return;
+    }
+    const results = ctx.skillsModule.search(arg);
+    if (results.length === 0) {
+      console.log(t("repl.no_skill_match", { query: arg }));
+      return;
+    }
+    console.log(pc2.bold(t("repl.skills_matching", { query: arg })));
+    for (const skill of results) {
+      const tokens = estimateTokens(skill.content);
+      console.log(`  ${pc2.cyan(skill.name)}  ${pc2.dim(`(${tokens} tokens)`)}  ${skill.description.slice(0, 60)}`);
+    }
+  };
+  const skillHandlers = {
+    list: listSkills,
+    loaded: listLoaded,
+    load: loadSkill,
+    unload: unloadSkill,
+    search: searchSkills
+  };
   ctx.registerCommand({
     name: "skill",
     description: t("repl.skill"),
     usage: t("repl.skill_usage"),
     action: (args) => {
       const subcmd = args[0];
-      const arg = args.slice(1).join(" ");
-      if (!subcmd || subcmd === "list") {
-        const available = ctx.skillsModule.getAvailable();
-        if (available.length === 0) {
-          console.log(t("repl.no_skills"));
-          return;
-        }
-        console.log(pc2.bold(t("repl.available_skills")));
-        for (const skill of available) {
-          const tokens = estimateTokens(skill.content);
-          const loaded = ctx.skillsModule.getLoaded().some((s) => s.name === skill.name);
-          const marker = loaded ? pc2.green(" [loaded]") : "";
-          console.log(`  ${pc2.cyan(skill.name)}${marker}  ${pc2.dim(`(${tokens} tokens)`)}  ${skill.description.slice(0, 60)}`);
-        }
-        return;
-      }
-      if (subcmd === "loaded") {
-        const loaded = ctx.skillsModule.getLoaded();
-        const budget = ctx.skillsModule.getBudget();
-        if (loaded.length === 0) {
-          console.log(t("repl.no_loaded"));
-          return;
-        }
-        console.log(pc2.bold(t("repl.loaded_skills")));
-        for (const skill of loaded) {
-          const tokens = estimateTokens(skill.content);
-          console.log(`  ${pc2.cyan(skill.name)}  ${pc2.dim(`(${tokens} tokens)`)}  ${skill.description.slice(0, 60)}`);
-        }
-        console.log(pc2.dim(`
-  ${t("repl.budget", { used: budget.used, total: budget.total, remaining: budget.remaining })}`));
-        return;
-      }
-      if (subcmd === "load") {
-        if (!arg) {
-          console.log(t("repl.skill_load_usage"));
-          return;
-        }
-        const result = ctx.skillsModule.loadByName(arg);
-        if (result.success) {
-          console.log(pc2.green(result.message));
-        } else {
-          console.log(pc2.red(result.message));
-        }
+      const handler = subcmd ? skillHandlers[subcmd] : skillHandlers.list;
+      if (!handler) {
+        console.log(pc2.red(t("repl.skill_unknown_sub", { subcmd })));
+        console.log(t("repl.skill_usage"));
         return;
       }
-      if (subcmd === "unload") {
-        if (!arg) {
-          console.log(t("repl.skill_unload_usage"));
-          return;
-        }
-        if (ctx.skillsModule.unload(arg)) {
-          console.log(pc2.green(t("repl.skill_unloaded", { name: arg })));
-        } else {
-          console.log(pc2.red(t("repl.skill_not_loaded", { name: arg })));
-        }
-        return;
-      }
-      if (subcmd === "search") {
-        if (!arg) {
-          console.log(t("repl.skill_search_usage"));
-          return;
-        }
-        const results = ctx.skillsModule.search(arg);
-        if (results.length === 0) {
-          console.log(t("repl.no_skill_match", { query: arg }));
-          return;
-        }
-        console.log(pc2.bold(t("repl.skills_matching", { query: arg })));
-        for (const skill of results) {
-          const tokens = estimateTokens(skill.content);
-          console.log(`  ${pc2.cyan(skill.name)}  ${pc2.dim(`(${tokens} tokens)`)}  ${skill.description.slice(0, 60)}`);
-        }
-        return;
-      }
-      console.log(pc2.red(t("repl.skill_unknown_sub", { subcmd })));
-      console.log(t("repl.skill_usage"));
+      handler(args.slice(1));
     }
   });
 }
@@ -37221,6 +37306,7 @@ var init_repl_commands = __esm(() => {
   init_i18n();
   init_setup();
   init_config2();
+  init_presets();
   init_budget();
   init_token_counter();
   init_map_command();
@@ -39549,22 +39635,17 @@ class SkillNameProvider {
     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") {
-      const available = this.skillsModule.getAvailable();
-      const names = available.map((s) => s.name);
-      if (!ctx.partial)
-        return names;
-      return names.filter((n) => n.toLowerCase().includes(ctx.partial.toLowerCase()));
-    }
-    if (subcmd === "unload") {
-      const loaded = this.skillsModule.getLoaded();
-      const names = loaded.map((s) => s.name);
-      if (!ctx.partial)
-        return names;
-      return names.filter((n) => n.toLowerCase().includes(ctx.partial.toLowerCase()));
-    }
-    return [];
+    const sources = {
+      load: () => this.skillsModule.getAvailable().map((s) => s.name),
+      unload: () => this.skillsModule.getLoaded().map((s) => s.name)
+    };
+    const source = sources[ctx.tokens[1]];
+    if (!source)
+      return [];
+    const names = source();
+    if (!ctx.partial)
+      return names;
+    return names.filter((n) => n.toLowerCase().includes(ctx.partial.toLowerCase()));
   }
 }
 
@@ -40417,7 +40498,7 @@ class Repl {
       this.completer.registerProvider(new SubcommandProvider("skill", ["list", "loaded", "load", "unload", "search"]));
       this.completer.registerProvider(new SkillNameProvider(this.skillsModule));
     }
-    this.completer.registerProvider(new SubcommandProvider("provider", ["list", "use"]));
+    this.completer.registerProvider(new SubcommandProvider("provider", ["list", "use", "add"]));
     this.completer.registerProvider(new SubcommandProvider("model", ["list", "use"]));
     const entryLabels = this.config.provider?.entries?.map((e) => e.label || e.type) ?? [];
     if (entryLabels.length > 0) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "micro-models-agent",
-  "version": "0.62.0",
+  "version": "0.63.0",
   "description": "Micro Models Agent (MMA) — LLM agent harness for small models (Qwen3.5-9B, 32K-64K context)",
   "type": "module",
   "bin": {