micro-models-agent 0.60.1 → 0.61.0

package/CHANGELOG.md

@@ -4,6 +4,17 @@ 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.61.0] - 2026-09-15
+
+### Added
+- **Budget share controls**: `mma context --system <f>` / `--reserve <f>` and REPL `/context system <f>` / `reserve <f>` set `contextBudget.systemPrompt` / `responseReserve` (validated 0.05–0.9, system + reserve < 0.95). `mma context` and `/context` with no argument now print the budget breakdown (system / reserve / history in tokens and %). `mma config set contextBudget.systemPrompt <f>` keeps working.
+
+### Changed
+- **Overflow fix advice**: the "system prompt exceeds budget" warning no longer only snaps to a coarse standard context size — a 32K project was jumping straight to `131072`, which looked arbitrary and was often unusable on a local model. The hint (`prompt.overflow.hint_*`, en+ru) now states the raw requirement (`needs ~N system tokens; current budget: W × f = B`) and both levers: raise `contextWindow` to the exact minimum (with the standard size) **or** keep the window and raise `contextBudget.systemPrompt` to the required share (`mma context --system <f>`).
+
+### Fixed
+- **`mma context` ignored `MMA_CONFIG_DIR`**: it saved to a hardcoded `~/.mma/config.json`; it now writes to the config dir resolved by bootstrap.
+
 ## [0.60.1] - 2026-09-15
 
 ### Fixed

package/dist/i18n/en.json

@@ -279,6 +279,14 @@
   "cli.manage_context": "Manage context window",
   "cli.invalid_context_size": "Invalid context size. Must be a number >= 1024",
   "cli.context_set": "Context window set to: {size} tokens",
+  "cli.context_budget_header": "Context budget (window {window} tokens):",
+  "cli.context_system_line": "  system prompt: {tokens} tokens ({percent}%)",
+  "cli.context_reserve_line": "  response reserve: {tokens} tokens ({percent}%)",
+  "cli.context_history_line": "  history: {tokens} tokens ({percent}%)",
+  "cli.context_system_fraction": "System-prompt share of the context window (0.05–0.9)",
+  "cli.context_reserve_fraction": "Response-reserve share of the context window (0.05–0.9)",
+  "cli.context_fraction_set": "{key} share set to {value}",
+  "cli.context_invalid_fraction": "Invalid share. Use a number between 0.05 and 0.9 (system + reserve must stay below 0.95).",
   "repl.reload": "Reload agent with current config",
   "repl.reload_usage": "Usage: /reload",
   "repl.reloading": "Reloading agent...",
@@ -442,7 +450,7 @@
   "repl.sysprompt_desc": "Show system prompt",
   "repl.sysprompt_tokens": "System prompt ({count} tokens):",
   "repl.excluded_blocks": "\nExcluded blocks: {count}",
-  "repl.context_usage": "Usage: /context <size>  (min 1024)",
+  "repl.context_usage": "Usage: /context [<size> | system <fraction> | reserve <fraction>]  (min 1024; fractions 0.05–0.9)",
   "repl.msgs": "msgs",
   "repl.max_iters": "Max iters:",
   "repl.stuck_thresh": "Stuck thresh:",
@@ -729,6 +737,9 @@
   "prompt.overflow.summarizing": "System prompt overflow: summarizing \"{label}\" ({original} tok → {budget} tok budget) with the model…",
   "prompt.overflow.truncating": "System prompt overflow: truncating \"{label}\" ({original} tok) — summarization unavailable.",
   "prompt.overflow.summarize_failed": "System prompt overflow: summarization failed for \"{label}\": {error} — falling back to truncation.",
+  "prompt.overflow.hint_needed": "the prompt needs ~{needed} system tokens (current budget: {window} × {fraction} = {budget})",
+  "prompt.overflow.hint_window": "raise contextWindow to at least {required} (standard size {recommended}) — {how}",
+  "prompt.overflow.hint_fraction": "or keep the window and raise contextBudget.systemPrompt to ~{fraction} (run: mma context --system {fraction})",
   "prompt.overflow.exceeded": "Prompt overflow: \"{label}\" ({original} tok) exceeded the system-prompt budget ({budget} tok) — {mode} to {resolved} tok. To fit fully, {hint}.",
   "prompt.overflow.failed": "Prompt overflow resolution failed: {error} — oversized blocks will be dropped.",
   "prompt.overflow.startup": "Startup check: {block} ({original} tok) exceeds the system-prompt budget ({budget} tok) — it will be summarized/truncated before the first run. To include it fully, {hint}.",

package/dist/i18n/ru.json

@@ -277,6 +277,14 @@
   "cli.manage_context": "Управление контекстным окном",
   "cli.invalid_context_size": "Некорректный размер контекста. Должно быть число >= 1024",
   "cli.context_set": "Контекстное окно установлено: {size} токенов",
+  "cli.context_budget_header": "Бюджет контекста (окно {window} токенов):",
+  "cli.context_system_line": "  системный промпт: {tokens} токенов ({percent}%)",
+  "cli.context_reserve_line": "  резерв ответа: {tokens} токенов ({percent}%)",
+  "cli.context_history_line": "  история: {tokens} токенов ({percent}%)",
+  "cli.context_system_fraction": "Доля системного промпта в контекстном окне (0.05–0.9)",
+  "cli.context_reserve_fraction": "Доля резерва ответа в контекстном окне (0.05–0.9)",
+  "cli.context_fraction_set": "Доля {key} установлена: {value}",
+  "cli.context_invalid_fraction": "Некорректная доля. Нужно число от 0.05 до 0.9 (системный + резерв должны оставаться ниже 0.95).",
   "cli.set_model": "Установить модель по умолчанию",
   "cli.model_set": "Модель установлена: {name}",
   "cli.certify": "Запустить сертификационный набор для модели",
@@ -436,7 +444,7 @@
   "repl.sysprompt_desc": "Показать системный промпт",
   "repl.sysprompt_tokens": "Системный промпт ({count} токенов):",
   "repl.excluded_blocks": "\nИсключённые блоки: {count}",
-  "repl.context_usage": "Использование: /context <размер>  (мин 1024)",
+  "repl.context_usage": "Использование: /context [<размер> | system <доля> | reserve <доля>]  (мин 1024; доли 0.05–0.9)",
   "repl.msgs": "сообщ.",
   "repl.max_iters": "Макс итераций:",
   "repl.stuck_thresh": "Порог зависания:",
@@ -729,6 +737,9 @@
   "prompt.overflow.summarizing": "Переполнение системного промпта: суммаризирую \"{label}\" ({original} токенов → бюджет {budget} токенов) моделью…",
   "prompt.overflow.truncating": "Переполнение системного промпта: обрезаю \"{label}\" ({original} токенов) — суммаризация недоступна.",
   "prompt.overflow.summarize_failed": "Переполнение системного промпта: не удалось суммаризировать \"{label}\": {error} — перехожу к обрезке.",
+  "prompt.overflow.hint_needed": "промпту нужно ~{needed} токенов системного бюджета (сейчас: {window} × {fraction} = {budget})",
+  "prompt.overflow.hint_window": "подними contextWindow минимум до {required} (стандартный размер {recommended}) — {how}",
+  "prompt.overflow.hint_fraction": "или оставь окно и подними contextBudget.systemPrompt до ~{fraction} (выполни: mma context --system {fraction})",
   "prompt.overflow.exceeded": "Промпт переполнен: \"{label}\" ({original} токенов) превысил бюджет системного промпта ({budget} токенов) — {mode} до {resolved} токенов. Чтобы включить полностью, {hint}.",
   "prompt.overflow.failed": "Не удалось разрешить переполнение промпта: {error} — слишком большие блоки будут отброшены.",
   "prompt.overflow.startup": "Проверка при старте: {block} ({original} токенов) превышает бюджет системного промпта ({budget} токенов) — будет суммаризован/обрезан перед первым запуском. Чтобы включить полностью, {hint}.",

package/dist/main.js

@@ -2728,6 +2728,14 @@ Fix the error and re-edit the file (a clean write clears the failure), or mark t
     "cli.manage_context": "Manage context window",
     "cli.invalid_context_size": "Invalid context size. Must be a number >= 1024",
     "cli.context_set": "Context window set to: {size} tokens",
+    "cli.context_budget_header": "Context budget (window {window} tokens):",
+    "cli.context_system_line": "  system prompt: {tokens} tokens ({percent}%)",
+    "cli.context_reserve_line": "  response reserve: {tokens} tokens ({percent}%)",
+    "cli.context_history_line": "  history: {tokens} tokens ({percent}%)",
+    "cli.context_system_fraction": "System-prompt share of the context window (0.05–0.9)",
+    "cli.context_reserve_fraction": "Response-reserve share of the context window (0.05–0.9)",
+    "cli.context_fraction_set": "{key} share set to {value}",
+    "cli.context_invalid_fraction": "Invalid share. Use a number between 0.05 and 0.9 (system + reserve must stay below 0.95).",
     "repl.reload": "Reload agent with current config",
     "repl.reload_usage": "Usage: /reload",
     "repl.reloading": "Reloading agent...",
@@ -2893,7 +2901,7 @@ Available commands:`,
     "repl.sysprompt_tokens": "System prompt ({count} tokens):",
     "repl.excluded_blocks": `
 Excluded blocks: {count}`,
-    "repl.context_usage": "Usage: /context <size>  (min 1024)",
+    "repl.context_usage": "Usage: /context [<size> | system <fraction> | reserve <fraction>]  (min 1024; fractions 0.05–0.9)",
     "repl.msgs": "msgs",
     "repl.max_iters": "Max iters:",
     "repl.stuck_thresh": "Stuck thresh:",
@@ -3206,6 +3214,9 @@ Apply a matching solution from these results. If none is relevant — do NOT rep
     "prompt.overflow.summarizing": 'System prompt overflow: summarizing "{label}" ({original} tok → {budget} tok budget) with the model…',
     "prompt.overflow.truncating": 'System prompt overflow: truncating "{label}" ({original} tok) — summarization unavailable.',
     "prompt.overflow.summarize_failed": 'System prompt overflow: summarization failed for "{label}": {error} — falling back to truncation.',
+    "prompt.overflow.hint_needed": "the prompt needs ~{needed} system tokens (current budget: {window} × {fraction} = {budget})",
+    "prompt.overflow.hint_window": "raise contextWindow to at least {required} (standard size {recommended}) — {how}",
+    "prompt.overflow.hint_fraction": "or keep the window and raise contextBudget.systemPrompt to ~{fraction} (run: mma context --system {fraction})",
     "prompt.overflow.exceeded": 'Prompt overflow: "{label}" ({original} tok) exceeded the system-prompt budget ({budget} tok) — {mode} to {resolved} tok. To fit fully, {hint}.',
     "prompt.overflow.failed": "Prompt overflow resolution failed: {error} — oversized blocks will be dropped.",
     "prompt.overflow.startup": "Startup check: {block} ({original} tok) exceeds the system-prompt budget ({budget} tok) — it will be summarized/truncated before the first run. To include it fully, {hint}.",
@@ -3531,6 +3542,14 @@ var init_ru = __esm(() => {
     "cli.manage_context": "Управление контекстным окном",
     "cli.invalid_context_size": "Некорректный размер контекста. Должно быть число >= 1024",
     "cli.context_set": "Контекстное окно установлено: {size} токенов",
+    "cli.context_budget_header": "Бюджет контекста (окно {window} токенов):",
+    "cli.context_system_line": "  системный промпт: {tokens} токенов ({percent}%)",
+    "cli.context_reserve_line": "  резерв ответа: {tokens} токенов ({percent}%)",
+    "cli.context_history_line": "  история: {tokens} токенов ({percent}%)",
+    "cli.context_system_fraction": "Доля системного промпта в контекстном окне (0.05–0.9)",
+    "cli.context_reserve_fraction": "Доля резерва ответа в контекстном окне (0.05–0.9)",
+    "cli.context_fraction_set": "Доля {key} установлена: {value}",
+    "cli.context_invalid_fraction": "Некорректная доля. Нужно число от 0.05 до 0.9 (системный + резерв должны оставаться ниже 0.95).",
     "cli.set_model": "Установить модель по умолчанию",
     "cli.model_set": "Модель установлена: {name}",
     "cli.certify": "Запустить сертификационный набор для модели",
@@ -3692,7 +3711,7 @@ var init_ru = __esm(() => {
     "repl.sysprompt_tokens": "Системный промпт ({count} токенов):",
     "repl.excluded_blocks": `
 Исключённые блоки: {count}`,
-    "repl.context_usage": "Использование: /context <размер>  (мин 1024)",
+    "repl.context_usage": "Использование: /context [<размер> | system <доля> | reserve <доля>]  (мин 1024; доли 0.05–0.9)",
     "repl.msgs": "сообщ.",
     "repl.max_iters": "Макс итераций:",
     "repl.stuck_thresh": "Порог зависания:",
@@ -4012,6 +4031,9 @@ var init_ru = __esm(() => {
     "prompt.overflow.summarizing": 'Переполнение системного промпта: суммаризирую "{label}" ({original} токенов → бюджет {budget} токенов) моделью…',
     "prompt.overflow.truncating": 'Переполнение системного промпта: обрезаю "{label}" ({original} токенов) — суммаризация недоступна.',
     "prompt.overflow.summarize_failed": 'Переполнение системного промпта: не удалось суммаризировать "{label}": {error} — перехожу к обрезке.',
+    "prompt.overflow.hint_needed": "промпту нужно ~{needed} токенов системного бюджета (сейчас: {window} × {fraction} = {budget})",
+    "prompt.overflow.hint_window": "подними contextWindow минимум до {required} (стандартный размер {recommended}) — {how}",
+    "prompt.overflow.hint_fraction": "или оставь окно и подними contextBudget.systemPrompt до ~{fraction} (выполни: mma context --system {fraction})",
     "prompt.overflow.exceeded": 'Промпт переполнен: "{label}" ({original} токенов) превысил бюджет системного промпта ({budget} токенов) — {mode} до {resolved} токенов. Чтобы включить полностью, {hint}.',
     "prompt.overflow.failed": "Не удалось разрешить переполнение промпта: {error} — слишком большие блоки будут отброшены.",
     "prompt.overflow.startup": "Проверка при старте: {block} ({original} токенов) превышает бюджет системного промпта ({budget} токенов) — будет суммаризован/обрезан перед первым запуском. Чтобы включить полностью, {hint}.",
@@ -14784,6 +14806,33 @@ function recommendContextSize(neededSystemTokens) {
   const sizes = [8192, 16384, 32768, 65536, 131072, 262144];
   return sizes.find((s) => Math.floor(s * 0.1) >= neededSystemTokens) ?? sizes[sizes.length - 1];
 }
+function requiredContextWindow(neededTokens, systemFraction) {
+  const fraction = systemFraction > 0 ? systemFraction : 0.1;
+  return Math.ceil(neededTokens / fraction);
+}
+function requiredSystemFraction(neededTokens, contextWindow) {
+  if (contextWindow <= 0)
+    return 1;
+  return Math.min(1, Math.ceil(neededTokens / contextWindow * 100) / 100);
+}
+function overflowHint(config, configDir, neededTokens) {
+  const fraction = config.contextBudget?.systemPrompt ?? 0.1;
+  const budget = Math.floor(config.contextWindow * fraction);
+  const recommended = recommendContextSize(neededTokens);
+  const requiredWindow = requiredContextWindow(neededTokens, fraction);
+  const requiredFraction = requiredSystemFraction(neededTokens, config.contextWindow);
+  const how = configDir ? contextWindowHint(config, configDir, recommended) : `increase contextWindow (e.g. to ${recommended})`;
+  return [
+    t("prompt.overflow.hint_needed", {
+      needed: neededTokens,
+      window: config.contextWindow,
+      fraction,
+      budget
+    }),
+    t("prompt.overflow.hint_window", { required: requiredWindow, recommended, how }),
+    t("prompt.overflow.hint_fraction", { fraction: requiredFraction })
+  ].join(" ");
+}
 var HINT_BLOCK_TOKENS = 60, CHARS_PER_TOKEN = 4, KIND_ORDER, KIND_LABEL, KIND_SOURCE_FILE;
 var init_prompt_overflow = __esm(() => {
   init_prompt_builder();
@@ -14964,8 +15013,8 @@ class Agent {
         this.promptOverrides.set(r.kind, r);
     }
     this.overflowHintBlock = res.hintBlock;
-    const recommended = recommendContextSize(dry.blocks.filter((b) => b.included).reduce((s, b) => s + b.tokens, 0) + overflow.reduce((s, b) => s + b.estimatedTokens, 0) + HINT_BLOCK_TOKENS);
-    const hint = this.deps.configDir ? contextWindowHint(cfg, this.deps.configDir, recommended) : `increase contextWindow (e.g. to ${recommended})`;
+    const needed = dry.blocks.filter((b) => b.included).reduce((s, b) => s + b.tokens, 0) + overflow.reduce((s, b) => s + b.estimatedTokens, 0) + HINT_BLOCK_TOKENS;
+    const hint = overflowHint(cfg, this.deps.configDir, needed);
     for (const w of res.warnings) {
       this.deps.logger.warn(t("prompt.overflow.exceeded", {
         label: w.label,
@@ -26836,8 +26885,7 @@ async function bootstrap(configDir, projectDir, noAgentsMd, exitOnComplete, reas
     const dry = dryRunOverflow([...promptBlocks, ...dynamicBlocks], systemBudget);
     if (dry.overflow.length > 0) {
       const overflowTokens = dry.overflow.reduce((s, b) => s + b.estimatedTokens, 0);
-      const recommended = recommendContextSize(dry.includedTokens + overflowTokens);
-      const hint = contextWindowHint(config, dir, recommended);
+      const hint = overflowHint(config, dir, dry.includedTokens + overflowTokens);
       for (const b of dry.overflow) {
         logger4.warn(t("prompt.overflow.startup", {
           block: b.kind === "instructions" ? "AGENTS.md" : "project map",
@@ -27742,6 +27790,49 @@ var init_map_command = __esm(() => {
   init_i18n();
 });
 
+// src/config/budget.ts
+function budgetBreakdown(config) {
+  const window = config.contextWindow;
+  const budget = config.contextBudget;
+  const system = Math.floor(window * budget.systemPrompt);
+  const reserve = Math.floor(window * budget.responseReserve);
+  const history = window - system - reserve;
+  return {
+    window,
+    system,
+    reserve,
+    history,
+    systemFraction: budget.systemPrompt,
+    reserveFraction: budget.responseReserve,
+    historyFraction: window > 0 ? history / window : 0
+  };
+}
+function setBudgetShare(config, key, value) {
+  if (!Number.isFinite(value) || value < MIN_SHARE || value > MAX_SHARE)
+    return "range";
+  const budget = config.contextBudget;
+  const nextSystem = key === "system" ? value : budget.systemPrompt;
+  const nextReserve = key === "reserve" ? value : budget.responseReserve;
+  if (nextSystem + nextReserve > MAX_COMBINED)
+    return "combined";
+  budget[key === "system" ? "systemPrompt" : "responseReserve"] = value;
+  return null;
+}
+function budgetBreakdownLines(config) {
+  const bd = budgetBreakdown(config);
+  const pct = (f) => Math.round(f * 100);
+  return [
+    t("cli.context_budget_header", { window: bd.window }),
+    t("cli.context_system_line", { tokens: bd.system, percent: pct(bd.systemFraction) }),
+    t("cli.context_reserve_line", { tokens: bd.reserve, percent: pct(bd.reserveFraction) }),
+    t("cli.context_history_line", { tokens: bd.history, percent: pct(bd.historyFraction) })
+  ];
+}
+var MIN_SHARE = 0.05, MAX_SHARE = 0.9, MAX_COMBINED = 0.95;
+var init_budget = __esm(() => {
+  init_i18n();
+});
+
 // node_modules/yaml/dist/nodes/identity.js
 var require_identity = __commonJS((exports) => {
   var ALIAS = Symbol.for("yaml.alias");
@@ -36293,11 +36384,28 @@ function registerProviderCommands(ctx) {
   ctx.registerCommand({
     name: "context",
     description: t("cli.manage_context"),
-    usage: "/context <size>",
+    usage: t("repl.context_usage"),
     action: async (args) => {
+      const save = async () => {
+        const configPath = join54(ctx.configDir, "config.json");
+        saveConfig(ctx.config, configPath, dirname24(configPath));
+        await ctx.agent.reconfigure(ctx.config);
+      };
       if (args.length === 0) {
-        console.log(`/context ${t("repl.context")}  ${ctx.config.contextWindow}`);
-        console.log(t("repl.context_usage"));
+        for (const line of budgetBreakdownLines(ctx.config))
+          console.log(line);
+        console.log(pc2.dim(t("repl.context_usage")));
+        return;
+      }
+      if (args[0] === "system" || args[0] === "reserve") {
+        const key = args[0];
+        const value = Number(args[1]);
+        if (setBudgetShare(ctx.config, key, value) !== null) {
+          console.log(pc2.yellow(t("cli.context_invalid_fraction")));
+          return;
+        }
+        await save();
+        console.log(pc2.green(t("cli.context_fraction_set", { key, value })));
         return;
       }
       const size = parseInt(args[0], 10);
@@ -36306,9 +36414,7 @@ function registerProviderCommands(ctx) {
         return;
       }
       ctx.config.contextWindow = size;
-      const configPath = join54(ctx.configDir, "config.json");
-      saveConfig(ctx.config, configPath, dirname24(configPath));
-      await ctx.agent.reconfigure(ctx.config);
+      await save();
       console.log(pc2.green(t("cli.context_set", { size })));
     }
   });
@@ -36695,6 +36801,7 @@ var init_repl_commands = __esm(() => {
   init_i18n();
   init_setup();
   init_config2();
+  init_budget();
   init_token_counter();
   init_map_command();
   init_utils();
@@ -37426,6 +37533,7 @@ function targetsFromProviders(entries) {
 // src/cli/commands.ts
 init_version();
 init_map_command();
+init_budget();
 
 // src/modules/updater/changelog-reader.ts
 import { readFileSync as readFileSync35, existsSync as existsSync53 } from "fs";
@@ -37686,9 +37794,25 @@ function buildModelCommands(program2) {
   });
 }
 function buildContextCommand(program2) {
-  program2.command("context").description(t("cli.manage_context")).argument("<size>", "Context window size in tokens").action(async (size) => {
-    const configPath = join53(homedir17(), ".mma", "config.json");
-    const { config } = await bootstrap();
+  program2.command("context").description(t("cli.manage_context")).argument("[size]", "Context window size in tokens (omit to show the budget breakdown)").option("--system <fraction>", t("cli.context_system_fraction")).option("--reserve <fraction>", t("cli.context_reserve_fraction")).action(async (size, opts) => {
+    const { config, configDir } = await bootstrap();
+    const configPath = join53(configDir, "config.json");
+    if (opts.system !== undefined || opts.reserve !== undefined) {
+      const key = opts.system !== undefined ? "system" : "reserve";
+      const value = Number(opts.system ?? opts.reserve);
+      if (setBudgetShare(config, key, value) !== null) {
+        console.log(t("cli.context_invalid_fraction"));
+        return;
+      }
+      saveConfig(config, configPath, dirname23(configPath));
+      console.log(t("cli.context_fraction_set", { key, value }));
+      return;
+    }
+    if (size === undefined) {
+      for (const line of budgetBreakdownLines(config))
+        console.log(line);
+      return;
+    }
     const contextWindow = parseInt(size, 10);
     if (isNaN(contextWindow) || contextWindow < 1024) {
       console.log(t("cli.invalid_context_size"));

package/package.json

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