micro-models-agent 0.20.1 → 0.21.0

package/dist/main.js

@@ -2303,6 +2303,8 @@ Command: {command}`,
     "tool.friendly.process_list": "Listing background processes",
     "tool.friendly.process_log": "Process output",
     "tool.friendly.process_kill": "Stopping process",
+    "plan.no_steps": "No plan steps specified. Provide concrete steps with files and commands.",
+    "plan.bad_steps": "Plan step quality unacceptable. Each step must describe concrete deliverables (files, packages, commands). Minimum 20 chars per step. Errors: {errors}",
     "plan.created": "Plan created: {title} ({steps} steps)",
     "plan.step_done": "Step {n}/{total}: {description} ✓",
     "plan.complete": "Task complete: {summary}",
@@ -2800,6 +2802,8 @@ var init_ru = __esm(() => {
     "tool.friendly.process_list": "Список фоновых процессов",
     "tool.friendly.process_log": "Вывод процесса",
     "tool.friendly.process_kill": "Остановка процесса",
+    "plan.no_steps": "Не указаны шаги плана. Укажите конкретные шаги с файлами и командами.",
+    "plan.bad_steps": "Качество шагов плана неприемлемо. Каждый шаг должен описывать конкретные deliverables (файлы, пакеты, команды). Минимум 20 символов на шаг. Ошибки: {errors}",
     "plan.created": "План создан: {title} ({steps} шагов)",
     "plan.step_done": "Шаг {n}/{total}: {description} ✓",
     "plan.complete": "Задача выполнена: {summary}",
@@ -10115,285 +10119,6 @@ var init_web_browse = __esm(() => {
   };
 });
 
-// src/tools/user-input.ts
-import * as readline from "readline";
-function parseSelection(input, optionCount, multiple) {
-  const trimmed = input.trim();
-  if (!trimmed)
-    return null;
-  const parts = trimmed.split(",").map((p) => p.trim());
-  if (!multiple && parts.length > 1)
-    return null;
-  const indexes = [];
-  for (const part of parts) {
-    if (!/^\d+$/.test(part))
-      return null;
-    const idx = Number(part) - 1;
-    if (idx < 0 || idx >= optionCount)
-      return null;
-    if (indexes.includes(idx))
-      return null;
-    indexes.push(idx);
-  }
-  return indexes.length ? indexes : null;
-}
-function formatMenu(question, options, opts = {}) {
-  const lines = [question];
-  options.forEach((opt, i) => {
-    lines.push(`  [${i + 1}] ${opt.label} — ${opt.description}`);
-  });
-  if (opts.allowCustom) {
-    lines.push(`  [${options.length + 1}] ${t("tool.user_input.custom_option")}`);
-  }
-  return lines.join(`
-`);
-}
-function choicePrompt(optionCount, multiple) {
-  return multiple ? t("tool.user_input.choice_multiple") : t("tool.user_input.choice_single", { max: optionCount });
-}
-function createRl() {
-  return readline.createInterface({
-    input: process.stdin,
-    output: process.stdout
-  });
-}
-function promptLine(rl, prompt) {
-  return new Promise((resolve11) => {
-    rl.question(prompt, (answer) => resolve11(answer));
-  });
-}
-async function askText(question) {
-  const rl = createRl();
-  try {
-    const answer = await promptLine(rl, `${question} `);
-    return answer.trim();
-  } finally {
-    rl.close();
-  }
-}
-async function askChoice(question, options, opts = {}) {
-  const multiple = opts.multiple ?? false;
-  const entryCount = options.length + (opts.allowCustom ? 1 : 0);
-  const customEntry = options.length;
-  const rl = createRl();
-  try {
-    console.log(formatMenu(question, options, opts));
-    for (;; ) {
-      const answer = await promptLine(rl, choicePrompt(entryCount, multiple));
-      const parsed = parseSelection(answer, entryCount, multiple);
-      if (parsed) {
-        return parsed.map((i) => opts.allowCustom && i === customEntry ? CUSTOM_INDEX : i);
-      }
-      console.log(t("tool.user_input.invalid"));
-    }
-  } finally {
-    rl.close();
-  }
-}
-async function askUser(question, opts = {}) {
-  const header = [opts.progress, opts.header].filter(Boolean).join(" — ");
-  const text = header ? `${header}
-${question}` : question;
-  if (!opts.options || opts.options.length === 0) {
-    const answer = await askText(text);
-    return answer ? [answer] : [];
-  }
-  const allowCustom = opts.custom ?? true;
-  const indexes = await askChoice(text, opts.options, {
-    multiple: opts.multiple,
-    allowCustom
-  });
-  const labels = [];
-  for (const idx of indexes) {
-    if (idx === CUSTOM_INDEX) {
-      const custom = await askText(t("tool.user_input.custom_prompt"));
-      if (custom)
-        labels.push(custom);
-    } else {
-      labels.push(opts.options[idx].label);
-    }
-  }
-  return labels;
-}
-var CUSTOM_INDEX = -1;
-var init_user_input = __esm(() => {
-  init_i18n();
-});
-
-// src/tools/question.ts
-function isOption(val) {
-  if (!val || typeof val !== "object")
-    return false;
-  const opt = val;
-  return typeof opt.label === "string" && typeof opt.description === "string";
-}
-function normalizeQuestions(args) {
-  const raw = args.questions;
-  if (Array.isArray(raw)) {
-    const specs = [];
-    for (const item of raw) {
-      if (!item || typeof item !== "object")
-        continue;
-      const q = item;
-      if (typeof q.question !== "string" || !q.question.trim())
-        continue;
-      const options = Array.isArray(q.options) ? q.options.filter(isOption) : undefined;
-      if (Array.isArray(q.options) && options.length === 0)
-        continue;
-      specs.push({
-        question: q.question,
-        header: typeof q.header === "string" ? q.header : undefined,
-        options,
-        multiple: q.multiple === true,
-        custom: q.custom === false ? false : undefined
-      });
-    }
-    return specs;
-  }
-  if (typeof args.question === "string" && args.question.trim()) {
-    return [{ question: args.question }];
-  }
-  return [];
-}
-var DESCRIPTION = `Use this tool when you need to ask the user questions during execution. This allows you to:
-1. Gather user preferences or requirements
-2. Clarify ambiguous instructions
-3. Get decisions on implementation choices as you work
-4. Offer choices to the user about what direction to take.
-
-Usage notes:
-- When "custom" is enabled (default), a "Type your own answer" option is added automatically; don't include "Other" or catch-all options
-- Answers are returned as arrays of labels; set "multiple": true to allow selecting more than one
-- If you recommend a specific option, make that the first option in the list and add "(Recommended)" at the end of the label
-- Execution blocks until the user answers every question
-- Omit "options" for a free-text question`, questionTool;
-var init_question = __esm(() => {
-  init_i18n();
-  init_user_input();
-  questionTool = {
-    name: "question",
-    description: DESCRIPTION,
-    tags: ["core"],
-    interactive: true,
-    parameters: {
-      type: "object",
-      properties: {
-        questions: {
-          type: "array",
-          description: "Questions to ask",
-          items: {
-            type: "object",
-            properties: {
-              question: { type: "string", description: "Complete question" },
-              header: {
-                type: "string",
-                description: "Very short label (max 30 chars)"
-              },
-              options: {
-                type: "array",
-                description: "Available choices; omit for a free-text question",
-                items: {
-                  type: "object",
-                  properties: {
-                    label: {
-                      type: "string",
-                      description: "Display text (1-5 words, concise)"
-                    },
-                    description: {
-                      type: "string",
-                      description: "Explanation of choice"
-                    }
-                  },
-                  required: ["label", "description"]
-                }
-              },
-              multiple: {
-                type: "boolean",
-                description: "Allow selecting multiple choices"
-              },
-              custom: {
-                type: "boolean",
-                description: "Allow typing a custom answer (default: true)"
-              }
-            },
-            required: ["question"]
-          }
-        },
-        question: {
-          type: "string",
-          description: "Legacy single free-text question"
-        }
-      }
-    },
-    handler: async (ctx, args) => {
-      if (ctx.exitOnComplete) {
-        return { success: false, output: t("tool.interactive_disabled") };
-      }
-      const questions = normalizeQuestions(args);
-      if (questions.length === 0) {
-        return { success: false, output: t("tool.question.no_questions") };
-      }
-      const answers = [];
-      for (let i = 0;i < questions.length; i++) {
-        const q = questions[i];
-        const progress = questions.length > 1 ? t("tool.question.progress", {
-          current: i + 1,
-          total: questions.length
-        }) : undefined;
-        answers.push(await askUser(q.question, {
-          header: q.header,
-          options: q.options,
-          multiple: q.multiple,
-          custom: q.custom,
-          progress
-        }));
-      }
-      const formatted = questions.map((q, i) => `"${q.question}"="${answers[i].length ? answers[i].join(", ") : t("tool.question.unanswered")}"`).join(", ");
-      return {
-        success: true,
-        output: t("tool.question.answered", { formatted })
-      };
-    }
-  };
-});
-
-// src/tools/approve.ts
-var approveTool;
-var init_approve = __esm(() => {
-  init_i18n();
-  init_user_input();
-  approveTool = {
-    name: "approve",
-    description: "Request user approval for an action. The user picks Yes or No from a menu.",
-    tags: ["core"],
-    interactive: true,
-    parameters: {
-      type: "object",
-      properties: {
-        action: {
-          type: "string",
-          description: "Description of the action requiring approval"
-        }
-      },
-      required: ["action"]
-    },
-    handler: async (ctx, args) => {
-      if (ctx.exitOnComplete) {
-        return { success: false, output: t("tool.interactive_disabled") };
-      }
-      const action = String(args.action || "");
-      const indexes = await askChoice(t("tool.approve_prompt", { action }), [
-        { label: t("tool.approve_yes"), description: t("tool.approve_yes_desc") },
-        { label: t("tool.approve_no"), description: t("tool.approve_no_desc") }
-      ]);
-      if (indexes[0] === 0) {
-        return { success: true, output: t("tool.approved") };
-      }
-      return { success: false, output: t("tool.rejected") };
-    }
-  };
-});
-
 // src/tools/load-skill.ts
 function createLoadSkillTool(skillsModule) {
   return {
@@ -12394,8 +12119,6 @@ function registerAllTools(registry2, skillsModule) {
     webSearchTool,
     webFetchTool,
     webBrowseTool,
-    questionTool,
-    approveTool,
     pipelineRunTool,
     mcpCallTool,
     searchHistoryTool,
@@ -12428,8 +12151,6 @@ var init_tools = __esm(() => {
   init_web_search();
   init_web_fetch();
   init_web_browse();
-  init_question();
-  init_approve();
   init_load_skill();
   init_pipeline_run();
   init_mcp_call();
@@ -12664,29 +12385,67 @@ var init_notify = __esm(() => {
 });
 
 // src/modules/execution/planner.ts
+function generatePlanId() {
+  const chars = "abcdefghijklmnopqrstuvwxyz0123456789";
+  let id = "";
+  for (let i = 0;i < 6; i++) {
+    id += chars[Math.floor(Math.random() * chars.length)];
+  }
+  return `plan_${id}`;
+}
+
 class PlanCreator {
   static isMultiStep(task) {
     const fileCount = (task.match(/\b[\w./-]+\.[a-z]+\b/gi) || []).length;
     if (fileCount > 1)
       return true;
-    const actionWords = ["implement", "create", "add", "build", "setup", "configure", "write", "make", "develop"];
+    const actionWords = [
+      "implement",
+      "create",
+      "add",
+      "build",
+      "setup",
+      "configure",
+      "write",
+      "make",
+      "develop"
+    ];
     const words = task.split(/\s+/);
     const hasActionWord = actionWords.some((w) => task.toLowerCase().includes(w));
     return hasActionWord && words.length > 8;
   }
-  static createPlan(title, stepDescriptions) {
+  static createPlan(title, stepDescriptions, baseDir) {
+    const stepCount = stepDescriptions.length;
     return {
-      title,
+      id: generatePlanId(),
+      title: `[${stepCount} ст.] ${title}`,
       steps: stepDescriptions.map((desc, i) => ({
         id: i + 1,
         description: desc,
         status: "pending"
       })),
-      createdAt: new Date().toISOString()
+      createdAt: new Date().toISOString(),
+      baseDir
     };
   }
+  static validateSteps(steps) {
+    const errors = [];
+    for (let i = 0;i < steps.length; i++) {
+      const s = steps[i].trim();
+      if (s.length < MIN_STEP_DESC_LENGTH) {
+        errors.push(`Step ${i + 1} too short (${s.length} chars). Describe WHAT files to create, WHICH packages to install, WHICH commands to run. Minimum ${MIN_STEP_DESC_LENGTH} chars.`);
+      }
+    }
+    return { valid: errors.length === 0, errors };
+  }
   static toPromptBlock(plan, currentStepIndex) {
-    const lines = [`[Plan: ${plan.title}] (steps: ${plan.steps.filter((s) => s.status === "done").length}/${plan.steps.length} done, current: step ${currentStepIndex + 1})`];
+    const date = plan.createdAt.slice(0, 10);
+    const lines = [
+      `[${plan.id}] ${plan.title}`,
+      `Dir: ${plan.baseDir}`,
+      `Created: ${date} | Progress: ${plan.steps.filter((s) => s.status === "done").length}/${plan.steps.length} done, current: step ${currentStepIndex + 1}`,
+      ``
+    ];
     for (const step of plan.steps) {
       const icon = step.status === "done" ? "[x]" : step.status === "in_progress" ? "[*]" : step.status === "failed" ? "[!]" : step.status === "skipped" ? "[-]" : "[ ]";
       const note = step.note ? ` — ${step.note}` : "";
@@ -12696,6 +12455,7 @@ class PlanCreator {
 `);
   }
 }
+var MIN_STEP_DESC_LENGTH = 20;
 
 // src/modules/execution/tracker.ts
 class PlanTracker {
@@ -12744,7 +12504,7 @@ class PlanTracker {
     const barWidth = 10;
     const filled = Math.round(done / total * barWidth);
     const bar = "█".repeat(filled) + "░".repeat(barWidth - filled);
-    return `[Plan: ${this.plan.title}]  ${done}/${total}  ${bar}  ${pct}%`;
+    return `[${this.plan.id}] ${this.plan.title}  ${done}/${total}  ${bar}  ${pct}%`;
   }
   toPromptBlock() {
     return PlanCreator.toPromptBlock(this.plan, this.currentStepIndex);
@@ -12993,10 +12753,12 @@ class PlanPersister {
   }
   save(plan) {
     const file = {
+      id: plan.id,
       title: plan.title,
       steps: plan.steps,
       createdAt: plan.createdAt,
-      updatedAt: new Date().toISOString()
+      updatedAt: new Date().toISOString(),
+      baseDir: plan.baseDir
     };
     writeFileSync9(this.filePath, JSON.stringify(file, null, 2), "utf-8");
   }
@@ -13007,9 +12769,11 @@ class PlanPersister {
       const raw = readFileSync14(this.filePath, "utf-8");
       const file = JSON.parse(raw);
       return {
+        id: file.id || "plan_legacy",
         title: file.title,
         steps: file.steps,
-        createdAt: file.createdAt
+        createdAt: file.createdAt,
+        baseDir: file.baseDir || process.cwd()
       };
     } catch {
       return null;
@@ -13097,7 +12861,15 @@ class ExecutionModule {
     return [
       {
         name: "plan",
-        description: 'Create, update, show, or abort a multi-step plan. Use "create" at the start of complex tasks. Use "update" after completing each step to track progress. Use "show" to re-print the current plan checklist.',
+        description: `Create, update, show, or abort a multi-step plan. Use "create" at the start of complex tasks. Use "update" after completing each step to track progress. Use "show" to re-print the current plan checklist.
+
+IMPORTANT — each step MUST be detailed and concrete:
+- Specify WHICH files to create (filenames with paths, e.g. "create src/components/Header.tsx...")
+- Specify WHICH packages to install (e.g. "run npm install react react-dom")
+- Specify WHICH commands to run with exact arguments
+- Minimum 20 characters per step description
+- BAD: "Настройка проекта"
+- GOOD: "Создать package.json с зависимостями react@18, vite@5, установить их через npm install"`,
         parameters: {
           type: "object",
           properties: {
@@ -13121,7 +12893,16 @@ class ExecutionModule {
             if (steps.length === 0) {
               return { success: false, output: t("plan.no_steps") };
             }
-            const plan = PlanCreator.createPlan(title, steps);
+            const validation = PlanCreator.validateSteps(steps);
+            if (!validation.valid) {
+              return {
+                success: false,
+                output: t("plan.bad_steps", {
+                  errors: validation.errors.join("; ")
+                })
+              };
+            }
+            const plan = PlanCreator.createPlan(title, steps, this.baseDir);
             this.setPlan(plan);
             const display = PlanCreator.toPromptBlock(plan, 0);
             return {
@@ -13336,9 +13117,7 @@ Sub-tasks: ${note}`
       "glob",
       "grep",
       "file_info",
-      "load_skill",
-      "question",
-      "approve"
+      "load_skill"
     ];
     if (allowedAlways.includes(call.name))
       return null;
@@ -14868,7 +14647,7 @@ function buildSystemInfo(config, baseDir, profileCompressed) {
     lines.push(``, `Windows environment — use Windows-compatible commands:`, `- Use "dir" instead of "ls". Use "dir /b" for bare listing.`, `- Use "type" or "Get-Content" instead of "cat".`, `- Use "cd" instead of "pwd". Use "echo %cd%" to print working directory.`, `- Use "copy" instead of "cp", "move" instead of "mv", "del" instead of "rm".`, `- Do not use "mkdir -p" — Windows mkdir creates intermediate dirs by default. Use the create_dir tool instead.`, `- Use forward slashes (/) or escaped backslashes (\\\\) in file paths.`, `- Your working directory is: ${baseDir}`);
   }
   lines.push(``, `Bash tool rules:`, `- Use the "workdir" parameter to run commands in a specific directory. Do NOT chain "cd dir && cmd" — the security module blocks the "&&" operator.`, `- Run one command per tool call. Split multi-step shell operations into separate bash calls.`, `- Background processes (dev servers, watchers, long-running npm install): use the "background: true" parameter or the tool will auto-detect and background them. Check output with process_log.`);
-  lines.push(``, `=== DEVELOPMENT RULES — follow these strictly ===`, ``, `1. DEPENDENCIES FIRST: Before writing any source code, ALWAYS install project dependencies (e.g., "npm install", "pip install -r requirements.txt", "cargo build", "go mod tidy"). Verify the package manager's lock file or dependency directory exists. Never write code that imports/uses packages that aren't installed yet.`, `2. TOOLKIT/FWK FIRST: If the task specifies a framework or UI library, initialize and configure it BEFORE writing application code. Run its project init command first, then add components/modules. Never write your own version of what the framework already provides.`, `3. ONE STEP AT A TIME: Follow the plan sequentially. Complete step N before starting step N+1. When a step is done: verify the deliverables exist and have real content (not empty), then call "plan update step=N status=done". Do not redo completed work.`, `4. VERIFY YOUR WORK: After creating/modifying files, verify they exist on disk. After installing dependencies, verify the package manager completed successfully. After any command, check its output for errors. Don't assume operations succeeded.`, `5. NO PREMATURE WORK: Do not create files for future steps. Do not add imports/references to packages or modules that haven't been installed yet. Do not reference files or components that don't exist yet. Build incrementally — one layer at a time.`, `6. WHEN STUCK: If a command fails 2+ times, STOP and try a different approach. Write files directly instead of using commands. Ask the user for help. Never repeat the same failing command more than twice.`);
+  lines.push(``, `=== DEVELOPMENT RULES — follow these strictly ===`, ``, `1. DEPENDENCIES FIRST: Before writing any source code, ALWAYS install project dependencies (e.g., "npm install", "pip install -r requirements.txt", "cargo build", "go mod tidy"). Verify the package manager's lock file or dependency directory exists. Never write code that imports/uses packages that aren't installed yet.`, `2. TOOLKIT/FWK FIRST: If the task specifies a framework or UI library, initialize and configure it BEFORE writing application code. Run its project init command first, then add components/modules. Never write your own version of what the framework already provides.`, `3. ONE STEP AT A TIME: Follow the plan sequentially. Complete step N before starting step N+1. When a step is done: verify the deliverables exist and have real content (not empty), then call "plan update step=N status=done". Do not redo completed work.`, `4. VERIFY YOUR WORK: After creating/modifying files, verify they exist on disk. After installing dependencies, verify the package manager completed successfully. After any command, check its output for errors. Don't assume operations succeeded.`, `5. NO PREMATURE WORK: Do not create files for future steps. Do not add imports/references to packages or modules that haven't been installed yet. Do not reference files or components that don't exist yet. Build incrementally — one layer at a time.`, `6. WHEN STUCK: If a command fails 2+ times, STOP and try a different approach. Write files directly instead of using commands. Ask the user for help. Never repeat the same failing command more than twice.`, ``, `=== PLAN QUALITY RULES — your plan MUST follow these ===`, ``, `- Each step must describe CONCRETE deliverables: exact filenames with paths, exact packages to install, exact CLI commands to run.`, `- A step like "Настройка проекта" or "Setup the project" is USELESS and will be REJECTED.`, `- A step like "Создать src/components/Header.tsx с хедером навигации, подключить в App.tsx" is GOOD.`, `- Include file extensions (.tsx, .css, .json) and directory paths. Never write vague steps.`, `- The plan must cover EVERYTHING needed: init → deps → framework setup → code → verification.`, `- Number of steps: 5-8 for a typical task. Too few means you're being vague. Too many means you're over-splitting.`);
   if (config.autoPlan) {
     lines.push(``, `Plan rule (MANDATORY): For ANY task that requires creating files, installing packages, or multiple actions — you MUST create a plan using the "plan" tool BEFORE starting work. Each step must describe a concrete deliverable (specific files to create, packages to install, commands to run). Do not combine unrelated work into one step.`);
   }
@@ -15629,7 +15408,7 @@ init_config();
 init_colors();
 init_i18n();
 init_spinner();
-import * as readline2 from "readline";
+import * as readline from "readline";
 
 // src/ui/box.ts
 init_string_width();
@@ -15809,7 +15588,7 @@ async function testChat(apiBase, apiKey, model) {
 }
 async function runSetup() {
   console.log(t("setup.title"));
-  const rl = readline2.createInterface({
+  const rl = readline.createInterface({
     input: process.stdin,
     output: process.stdout
   });
@@ -16676,7 +16455,7 @@ init_bootstrap();
 
 // src/cli/repl.ts
 init_colors();
-import * as readline3 from "readline";
+import * as readline2 from "readline";
 import { existsSync as existsSync35, readFileSync as readFileSync24, writeFileSync as writeFileSync15 } from "fs";
 import { join as join29, dirname as dirname10 } from "path";
 import { homedir as homedir14 } from "os";
@@ -17207,7 +16986,7 @@ class Repl {
     this.registerSessionCommands();
     this.registerSkillCommands();
     this.setupCompleter();
-    this.rl = readline3.createInterface({
+    this.rl = readline2.createInterface({
       input: process.stdin,
       output: process.stdout,
       prompt: pc.cyan("> "),
@@ -17844,7 +17623,7 @@ class Repl {
       this.running = false;
     });
     if (process.stdin.isTTY) {
-      readline3.emitKeypressEvents(process.stdin);
+      readline2.emitKeypressEvents(process.stdin);
       process.stdin.on("keypress", async (str, key) => {
         if (key.name === "escape") {
           const now = Date.now();

package/package.json

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