micro-models-agent 0.2.44 → 0.2.46

package/dist/agent/context.d.ts

@@ -1,4 +1,8 @@
 import type { ChatMessage } from '../llm/provider.js';
+/**
+ * Менеджер контекста — управляет историей сообщений и компактификацией.
+ * Создаётся один раз на сессию агента.
+ */
 export declare class ContextManager {
     private contextWindow;
     private compactThreshold;
@@ -6,13 +10,48 @@ export declare class ContextManager {
     private compacted;
     private _totalTokens;
     private _history;
+    /**
+     * @param contextWindow - размер контекстного окна модели (в токенах)
+     * @param compactThreshold - порог компактификации (по умолчанию 85%)
+     */
     constructor(contextWindow: number, compactThreshold?: number);
     get totalTokens(): number;
     get usagePercent(): number;
     get needsCompact(): boolean;
+    /**
+     * Оценивает важность сообщения для компактификации.
+     *
+     * Алгоритм:
+     * - System: 100 (всегда сохраняется отдельно)
+     * - Tool с ошибкой: 90 (важно для диагностики)
+     * - User с "важно"/"critical": 85
+     * - Tool с успехом: 70
+     * - Assistant с ошибкой/решением: 70-75
+     * - User-вопрос: 65
+     * - Обычный user/assistant: 40-60
+     * + Recency bonus: (index/total) * 20
+     */
     private scoreMessage;
+    /**
+     * Обновляет подсчёт токенов для всех сообщений.
+     * Использует WeakMap для кэширования — повторный подсчёт не выполняется.
+     */
     updateTokens(messages: ChatMessage[]): Promise<void>;
+    /**
+     * Компактификация истории сообщений.
+     *
+     * Стратегия:
+     * 1. Сохраняем system prompt (всегда первый)
+     * 2. Сохраняем первое user-сообщение (контекст задачи)
+     * 3. Остальные сообщения оцениваем по score
+     * 4. Сохраняем топ-6 по score + последние 6 по позиции
+     * 5. Остальные суммируем в "[Ранее в разговоре (сжато):]"
+     *
+     * @param messages - полная история сообщений
+     * @returns Сжатая история
+     */
     compact(messages: ChatMessage[]): ChatMessage[];
+    /** Форматирует строку использования контекста для отображения в UI */
     formatUsage(): string;
 }
 //# sourceMappingURL=context.d.ts.map

package/dist/agent/context.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../src/agent/context.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAWtD,qBAAa,cAAc;IAOvB,OAAO,CAAC,aAAa;IACrB,OAAO,CAAC,gBAAgB;IAP1B,OAAO,CAAC,UAAU,CAAsC;IACxD,OAAO,CAAC,SAAS,CAAK;IACtB,OAAO,CAAC,YAAY,CAAK;IACzB,OAAO,CAAC,QAAQ,CAA0C;gBAGhD,aAAa,EAAE,MAAM,EACrB,gBAAgB,GAAE,MAAa;IAGzC,IAAI,WAAW,IAAI,MAAM,CAExB;IAED,IAAI,YAAY,IAAI,MAAM,CAEzB;IAED,IAAI,YAAY,IAAI,OAAO,CAE1B;IAED,OAAO,CAAC,YAAY;IA+Bd,YAAY,CAAC,QAAQ,EAAE,WAAW,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAkB1D,OAAO,CAAC,QAAQ,EAAE,WAAW,EAAE,GAAG,WAAW,EAAE;IA8E/C,WAAW,IAAI,MAAM;CAiBtB"}
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../src/agent/context.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AA6BtD;;;GAGG;AACH,qBAAa,cAAc;IAWvB,OAAO,CAAC,aAAa;IACrB,OAAO,CAAC,gBAAgB;IAX1B,OAAO,CAAC,UAAU,CAAsC;IACxD,OAAO,CAAC,SAAS,CAAK;IACtB,OAAO,CAAC,YAAY,CAAK;IACzB,OAAO,CAAC,QAAQ,CAA0C;IAE1D;;;OAGG;gBAEO,aAAa,EAAE,MAAM,EACrB,gBAAgB,GAAE,MAAa;IAGzC,IAAI,WAAW,IAAI,MAAM,CAExB;IAED,IAAI,YAAY,IAAI,MAAM,CAEzB;IAED,IAAI,YAAY,IAAI,OAAO,CAE1B;IAED;;;;;;;;;;;;OAYG;IACH,OAAO,CAAC,YAAY;IA+BpB;;;OAGG;IACG,YAAY,CAAC,QAAQ,EAAE,WAAW,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAkB1D;;;;;;;;;;;;OAYG;IACH,OAAO,CAAC,QAAQ,EAAE,WAAW,EAAE,GAAG,WAAW,EAAE;IAiF/C,sEAAsE;IACtE,WAAW,IAAI,MAAM;CAiBtB"}

package/dist/agent/context.js

@@ -1,13 +1,21 @@
 import { countTokens } from '../llm/token-counter.js';
 import { getTheme } from '../styling/index.js';
 import { logInfo, logDebug } from '../logger.js';
+/**
+ * Менеджер контекста — управляет историей сообщений и компактификацией.
+ * Создаётся один раз на сессию агента.
+ */
 export class ContextManager {
     contextWindow;
     compactThreshold;
-    tokenCache = new WeakMap();
-    compacted = 0;
-    _totalTokens = 0;
-    _history = [];
+    tokenCache = new WeakMap(); // кэш подсчёта токенов
+    compacted = 0; // количество компактификаций за сессию
+    _totalTokens = 0; // общее количество токенов в истории
+    _history = []; // история по ролям
+    /**
+     * @param contextWindow - размер контекстного окна модели (в токенах)
+     * @param compactThreshold - порог компактификации (по умолчанию 85%)
+     */
     constructor(contextWindow, compactThreshold = 0.85) {
         this.contextWindow = contextWindow;
         this.compactThreshold = compactThreshold;
@@ -21,9 +29,22 @@ export class ContextManager {
     get needsCompact() {
         return this.usagePercent >= this.compactThreshold * 100;
     }
+    /**
+     * Оценивает важность сообщения для компактификации.
+     *
+     * Алгоритм:
+     * - System: 100 (всегда сохраняется отдельно)
+     * - Tool с ошибкой: 90 (важно для диагностики)
+     * - User с "важно"/"critical": 85
+     * - Tool с успехом: 70
+     * - Assistant с ошибкой/решением: 70-75
+     * - User-вопрос: 65
+     * - Обычный user/assistant: 40-60
+     * + Recency bonus: (index/total) * 20
+     */
     scoreMessage(msg, index, total) {
-        let score = 50; // base
-        // Role-based scoring
+        let score = 50; // базовая оценка
+        // Оценка по роли сообщения
         if (msg.role === 'system')
             score = 100;
         else if (msg.role === 'tool') {
@@ -53,11 +74,15 @@ export class ContextManager {
             else
                 score = 40;
         }
-        // Recency bonus (more recent = higher)
+        // Бонус за свежесть: чем позже сообщение, тем выше бонус
         const recencyBonus = (index / total) * 20;
         score += recencyBonus;
         return score;
     }
+    /**
+     * Обновляет подсчёт токенов для всех сообщений.
+     * Использует WeakMap для кэширования — повторный подсчёт не выполняется.
+     */
     async updateTokens(messages) {
         const start = performance.now();
         let total = 0;
@@ -75,11 +100,25 @@ export class ContextManager {
         const elapsed = (performance.now() - start).toFixed(1);
         logDebug('CONTEXT', `updateTokens: ${messages.length} msgs, ${total} tokens, ${elapsed}ms`);
     }
+    /**
+     * Компактификация истории сообщений.
+     *
+     * Стратегия:
+     * 1. Сохраняем system prompt (всегда первый)
+     * 2. Сохраняем первое user-сообщение (контекст задачи)
+     * 3. Остальные сообщения оцениваем по score
+     * 4. Сохраняем топ-6 по score + последние 6 по позиции
+     * 5. Остальные суммируем в "[Ранее в разговоре (сжато):]"
+     *
+     * @param messages - полная история сообщений
+     * @returns Сжатая история
+     */
     compact(messages) {
         const start = performance.now();
         logInfo('CONTEXT', `compact: ${messages.length} messages before`);
         if (messages.length <= 4)
             return messages;
+        // Извлекаем system prompt и первое user-сообщение
         const systemIdx = messages.findIndex(m => m.role === 'system');
         const system = systemIdx >= 0 ? [messages[systemIdx]] : [];
         const keepFirstUser = [];
@@ -94,24 +133,26 @@ export class ContextManager {
                 remaining.push(messages[i]);
             }
         }
-        // Score all messages
+        // Оцениваем все оставшиеся сообщения
         const scored = remaining.map((msg, i) => ({
             msg,
             score: this.scoreMessage(msg, i, remaining.length),
             tokens: this.tokenCache.get(msg) || 0,
         }));
-        // Sort by score descending
+        // Сортируем по убыванию score
         scored.sort((a, b) => b.score - a.score);
-        // Keep top 6 by score + last 6 by position
+        // Сохраняем топ-6 по score + последние 6 по позиции
         const recentMsgs = remaining.slice(-6);
         const recentIds = new Set(recentMsgs.map(m => m));
         const importantByScore = scored
             .filter(s => !recentIds.has(s.msg))
             .slice(0, 6)
             .map(s => s.msg);
+        // Сообщения, которые будут сжаты в summary
         const toCompact = remaining.filter(m => !recentMsgs.includes(m) && !importantByScore.includes(m));
         if (toCompact.length === 0)
             return messages;
+        // Формируем краткую сводку из сжатых сообщений
         const compactedPairs = [];
         let i = 0;
         while (i < toCompact.length) {
@@ -144,6 +185,7 @@ export class ContextManager {
         logInfo('CONTEXT', `compact: ${messages.length} → ${result.length} msgs in ${elapsed}ms`);
         return result;
     }
+    /** Форматирует строку использования контекста для отображения в UI */
     formatUsage() {
         const theme = getTheme();
         const pct = this.usagePercent;

package/dist/agent/context.js.map

@@ -1 +1 @@
-{"version":3,"file":"context.js","sourceRoot":"","sources":["../../src/agent/context.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../../src/agent/context.ts"],"names":[],"mappings":"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"}

package/dist/agent/loop.d.ts

@@ -3,6 +3,11 @@ import { ToolRegistry } from '../tools/registry.js';
 import { ContextManager } from './context.js';
 import type { OutputRenderer } from '../ui/renderer.js';
 import type { AgentMode } from '../config/types.js';
+/**
+ * Результат выполнения цикла агента.
+ * Содержит всю историю сообщений и опциональный pending-вопрос
+ * (если агент вызвал инструмент question и ждёт ответа пользователя).
+ */
 export interface AgentLoopResult {
     messages: ChatMessage[];
     questionPending?: {
@@ -10,6 +15,28 @@ export interface AgentLoopResult {
         choices?: string[];
     };
 }
+/**
+ * Запускает основной цикл ReAct-агента.
+ *
+ * Цикл работает до тех пор, пока:
+ * - Агент не перестанет вызывать инструменты (финальный текстовый ответ)
+ * - Не будет достигнут лимит ходов (maxSteps из конфига)
+ * - Пользователь не прервёт выполнение (abort signal)
+ *
+ * Стратегия обработки ошибок:
+ * - Пустые ответы: retry до 3 раз с подсказкой "Continue."
+ * - Невалидные tool calls: отправка обратной связи модели
+ * - Пустые ответы подряд >3: остановка цикла
+ *
+ * @param provider - провайдер LLM (OpenAI-совместимый)
+ * @param registry - реестр доступных инструментов
+ * @param prompt - начальный промпт пользователя
+ * @param contextManager - менеджер контекста (опциональный, создаётся новый если не передан)
+ * @param previousMessages - предыдущие сообщения для восстановления сессии
+ * @param renderer - рендерер вывода (Ink или readline)
+ * @param providerName - имя провайдера для отображения
+ * @param options - дополнительные опции (quiet, showThinking, mode)
+ */
 export declare function runAgentLoop(provider: LLMProvider, registry: ToolRegistry, prompt: string, contextManager?: ContextManager, previousMessages?: ChatMessage[], renderer?: OutputRenderer, providerName?: string, options?: {
     quiet?: boolean;
     showThinking?: boolean;

package/dist/agent/loop.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"loop.d.ts","sourceRoot":"","sources":["../../src/agent/loop.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACnE,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAEpD,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAc9C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAGxD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AA2BpD,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,WAAW,EAAE,CAAC;IACxB,eAAe,CAAC,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC;CAC5D;AAED,wBAAsB,YAAY,CAChC,QAAQ,EAAE,WAAW,EACrB,QAAQ,EAAE,YAAY,EACtB,MAAM,EAAE,MAAM,EACd,cAAc,CAAC,EAAE,cAAc,EAC/B,gBAAgB,CAAC,EAAE,WAAW,EAAE,EAChC,QAAQ,CAAC,EAAE,cAAc,EACzB,YAAY,CAAC,EAAE,MAAM,EACrB,OAAO,CAAC,EAAE;IAAE,KAAK,CAAC,EAAE,OAAO,CAAC;IAAC,YAAY,CAAC,EAAE,OAAO,CAAC;IAAC,IAAI,CAAC,EAAE,SAAS,CAAA;CAAE,GACtE,OAAO,CAAC,eAAe,CAAC,CAm0B1B"}
+{"version":3,"file":"loop.d.ts","sourceRoot":"","sources":["../../src/agent/loop.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACnE,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAEpD,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAc9C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAGxD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AA+CpD;;;;GAIG;AACH,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,WAAW,EAAE,CAAC;IACxB,eAAe,CAAC,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC;CAC5D;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAsB,YAAY,CAChC,QAAQ,EAAE,WAAW,EACrB,QAAQ,EAAE,YAAY,EACtB,MAAM,EAAE,MAAM,EACd,cAAc,CAAC,EAAE,cAAc,EAC/B,gBAAgB,CAAC,EAAE,WAAW,EAAE,EAChC,QAAQ,CAAC,EAAE,cAAc,EACzB,YAAY,CAAC,EAAE,MAAM,EACrB,OAAO,CAAC,EAAE;IAAE,KAAK,CAAC,EAAE,OAAO,CAAC;IAAC,YAAY,CAAC,EAAE,OAAO,CAAC;IAAC,IAAI,CAAC,EAAE,SAAS,CAAA;CAAE,GACtE,OAAO,CAAC,eAAe,CAAC,CAq1B1B"}

package/dist/agent/loop.js

@@ -19,7 +19,31 @@ import { loadConfig, saveConfig } from '../config/config.js';
 import { buildSystemPrompt } from './system-prompt.js';
 import { logInfo, logWarn, logError, logDebug, logToolCall, setStatusWriter, writeStatus } from '../logger.js';
 import { buildSubagentContext, runIsolatedLoop, extractAllToolCalls, validateToolCall, doChat } from '../tools/subagent.js';
-// extractAllToolCalls moved to src/tools/subagent.ts
+/**
+ * Основной цикл ReAct-агента.
+ *
+ * Архитектура цикла:
+ * 1. Сборка system prompt (кэшируется на время сессии)
+ * 2. Отправка запроса к LLM с историей сообщений
+ * 3. Парсинг tool calls из ответа модели (формат <tool_call>)
+ * 4. Валидация и исполнение каждого tool call
+ * 5. Добавление результата в историю
+ * 6. Повтор до завершения (нет tool calls) или лимита ходов
+ *
+ * Особенности:
+ * - Fallback-парсинг при невалидном JSON от маленьких моделей
+ * - Автоматическое компактирование контекста при приближении к лимиту
+ * - Retry с увеличением temperature при пустых ответах
+ * - Автодобавление скилов при обнаружении релевантных паттернов
+ *
+ * @module agent/loop
+ */
+/**
+ * Fallback-извлечение bash-команды из ответа модели.
+ * Используется когда основной парсинг tool calls не сработал
+ * (маленькие модели часто генерируют невалидный JSON).
+ * Применяет три regex-паттерна для поиска команды bash.
+ */
 function extractToolCallFallback(response) {
     const patterns = [
         /"name"\s*:\s*"bash"\s*,\s*"arguments"\s*:\s*\{\s*"cmd"\s*:\s*"((?:[^"\\]|\\.)*)"/,
@@ -36,12 +60,36 @@ function extractToolCallFallback(response) {
     }
     return null;
 }
+/**
+ * Запускает основной цикл ReAct-агента.
+ *
+ * Цикл работает до тех пор, пока:
+ * - Агент не перестанет вызывать инструменты (финальный текстовый ответ)
+ * - Не будет достигнут лимит ходов (maxSteps из конфига)
+ * - Пользователь не прервёт выполнение (abort signal)
+ *
+ * Стратегия обработки ошибок:
+ * - Пустые ответы: retry до 3 раз с подсказкой "Continue."
+ * - Невалидные tool calls: отправка обратной связи модели
+ * - Пустые ответы подряд >3: остановка цикла
+ *
+ * @param provider - провайдер LLM (OpenAI-совместимый)
+ * @param registry - реестр доступных инструментов
+ * @param prompt - начальный промпт пользователя
+ * @param contextManager - менеджер контекста (опциональный, создаётся новый если не передан)
+ * @param previousMessages - предыдущие сообщения для восстановления сессии
+ * @param renderer - рендерер вывода (Ink или readline)
+ * @param providerName - имя провайдера для отображения
+ * @param options - дополнительные опции (quiet, showThinking, mode)
+ */
 export async function runAgentLoop(provider, registry, prompt, contextManager, previousMessages, renderer, providerName, options) {
     logInfo('LOOP', `runAgentLoop started: "${prompt.slice(0, 50)}"`);
     renderer?.resetAbort?.();
+    // Парсинг ссылок на файлы в промпте (формат @path/to/file)
     const { prompt: enrichedPrompt, files } = await parseFileRefs(prompt);
     logDebug('LOOP', `parseFileRefs: ${files.length} files, prompt len: ${enrichedPrompt.length}`);
     const quiet = options?.quiet ?? false;
+    // Автозагрузка скилов из промпта (если пользователь указал @skill-name)
     const loadedSkills = loadSkillsFromRefs(prompt, process.cwd());
     const loadedSkillNames = new Set(loadedSkills.map(s => s.name));
     if (loadedSkills.length > 0) {
@@ -70,11 +118,13 @@ export async function runAgentLoop(provider, registry, prompt, contextManager, p
     }
     setStatusWriter(renderer ? (msg) => renderer.writeDim(`  ${msg}`) : null);
     writeStatus('Initializing...');
+    // Сборка system prompt (включает инструкции, информацию о проекте, скилы, память)
     const sysStart = performance.now();
     const systemPrompt = buildSystemPrompt(loadedSkills.length > 0 ? loadedSkills : undefined, options?.mode);
     const sysElapsed = ((performance.now() - sysStart) / 1000).toFixed(1);
     writeStatus(`Done (${sysElapsed}s)`);
     setStatusWriter(null);
+    // Начальное состояние истории: system prompt + предыдущие сообщения + текущий промпт
     const messages = [
         { role: 'system', content: systemPrompt },
         ...(previousMessages || []),
@@ -83,11 +133,11 @@ export async function runAgentLoop(provider, registry, prompt, contextManager, p
     const ctx = contextManager ?? new ContextManager(provider.contextWindow);
     const config = loadConfig();
     const maxSteps = config.agent.maxSteps ?? 100;
-    let consecutiveEmpty = 0;
+    let consecutiveEmpty = 0; // счётчик пустых ответов подряд
     let pendingSyntaxError = '';
     let aborted = false;
-    let continuationNudges = 0;
-    let directWriteStreak = 0; // consecutive write_file calls without subagent (across steps)
+    let continuationNudges = 0; // счётчик подсказок "продолжай работать"
+    let directWriteStreak = 0; // количество прямых write_file без subagent
     // Reset abort signal for this run
     if (renderer?.abortSignal === undefined) {
         // Renderer doesn't support abort — fine
@@ -99,14 +149,14 @@ export async function runAgentLoop(provider, registry, prompt, contextManager, p
         step: 0,
         maxSteps,
     });
+    // ─── Основной цикл ReAct ────────────────────────────────
     for (let step = 0; step < maxSteps; step++) {
         if (renderer?.abortSignal?.aborted) {
             aborted = true;
             break;
         }
         let skillsAutoLoaded = false;
-        // Track files created/modified in this session for completion reporting
-        const createdFiles = [];
+        const createdFiles = []; // отслеживание созданных/изменённых файлов
         logDebug('LOOP', `step ${step + 1}/${maxSteps} starting, ${messages.length} messages`);
         await ctx.updateTokens(messages);
         const skillNames = loadedSkills.map(s => s.name).join(', ');
@@ -120,6 +170,8 @@ export async function runAgentLoop(provider, registry, prompt, contextManager, p
             step: step + 1,
             maxSteps,
         });
+        // ─── Compaction контекста ─────────────────────────────
+        // Если использование контекста превышает порог (85%), компактируем историю
         if (ctx.needsCompact && messages.length > 6) {
             const before = messages.length;
             messages.splice(0, messages.length, ...ctx.compact(messages));
@@ -128,15 +180,16 @@ export async function runAgentLoop(provider, registry, prompt, contextManager, p
             }
             await ctx.updateTokens(messages);
         }
+        // ─── Запрос к LLM ────────────────────────────────────
         logInfo('LOOP', `calling doChat, messages: ${messages.length}, options.showThinking: ${options?.showThinking}`);
         const { response } = await doChat(provider, messages, renderer, renderer?.abortSignal, 1, options?.showThinking);
-        // Check if aborted during generation
+        // Проверка прерывания во время генерации
         if (renderer?.abortSignal?.aborted) {
             aborted = true;
             break;
         }
-        // Auto-load skills if the response contains @skill mentions
-        // Works with or without tool calls — agent can mention skills while working
+        // ─── Автозагрузка скилов по @упоминаниям ─────────────
+        // Если ответ содержит @skill-name, загружаем скил и пересобираем system prompt
         if (options?.mode !== 'fast' && !skillsAutoLoaded) {
             const suggestedSkillRefs = response.matchAll(/@(\w[\w-]*)/g);
             const newSkillNames = [];
@@ -161,6 +214,8 @@ export async function runAgentLoop(provider, registry, prompt, contextManager, p
                 continue;
             }
         } // end fast-mode skill block
+        // ─── Обработка пустых ответов ────────────────────────
+        // Маленькие модели иногда возвращают пустой ответ — повторяем с подсказкой
         if (!response.trim()) {
             logWarn('LOOP', `empty response #${consecutiveEmpty + 1}`);
             consecutiveEmpty++;
@@ -179,6 +234,8 @@ export async function runAgentLoop(provider, registry, prompt, contextManager, p
         }
         consecutiveEmpty = 0;
         messages.push({ role: 'assistant', content: response });
+        // ─── Парсинг tool calls ─────────────────────────────
+        // Извлекаем JSON из тегов <tool_call>...</tool_call> и валидируем
         const allJsonRaw = extractAllToolCalls(response);
         const validCalls = [];
         const invalidCalls = [];
@@ -203,6 +260,7 @@ export async function runAgentLoop(provider, registry, prompt, contextManager, p
                 }
             }
         }
+        // ─── Fallback: regex-извлечение при невалидном JSON ───
         if (validCalls.length === 0) {
             const fallback = extractToolCallFallback(response);
             if (fallback) {
@@ -261,9 +319,10 @@ export async function runAgentLoop(provider, registry, prompt, contextManager, p
             }
             continue;
         }
-        // Track consecutive read_file calls to the same file for consolidation
+        // ─── Enforce: лимиты на запись файлов ────────────────
+        // Отслеживание повторных чтений одного файла для консолидации
         let lastReadFile = null;
-        // ENFORCEMENT: if plan has 3+ steps, block write_file and force subagent
+        // Блокировка прямых write_file когда есть план с 3+ шагами —.force subagent
         const planSteps = showPlan();
         const hasMultiStepPlan = !planSteps.startsWith('No active plan') && (planSteps.match(/\n/g) || []).length >= 3;
         if (hasMultiStepPlan) {
@@ -323,7 +382,7 @@ export async function runAgentLoop(provider, registry, prompt, contextManager, p
                 }
             }
         }
-        // ENFORCEMENT: one file write at a time — block extra write_file/edit_file calls
+        // Блокировка нескольких записей файлов за один ответ — максимум одна
         const writeCalls = validCalls.filter(c => c.parsed.name === 'write_file' || c.parsed.name === 'edit_file');
         if (writeCalls.length > 1) {
             // Keep only the first write call, block the rest
@@ -341,6 +400,7 @@ export async function runAgentLoop(provider, registry, prompt, contextManager, p
                 renderer?.writeWarning(`  [blocked ${blocked.length} extra file writes — one at a time]`);
             }
         }
+        // ─── Исполнение tool calls ──────────────────────────
         for (const call of validCalls) {
             const { parsed, cmd } = call;
             const isBash = parsed.name === 'bash';
@@ -380,7 +440,7 @@ export async function runAgentLoop(provider, registry, prompt, contextManager, p
             let toolOutput = '';
             let toolExitCode = 0;
             const toolStart = performance.now();
-            // Native tool calls: plan/todo/question/approve
+            // ─── Нативные инструменты (plan/todo/question/approve) ──
             if (parsed.name === 'plan') {
                 const planName = String(parsed.arguments.TaskName || parsed.arguments.name || parsed.arguments.plan || 'Untitled');
                 const stepsRaw = parsed.arguments.Steps || parsed.arguments.steps || [];
@@ -566,7 +626,7 @@ export async function runAgentLoop(provider, registry, prompt, contextManager, p
                 }
             }
             else if (parsed.name === 'subagent') {
-                // Subagent: isolated context for a single task
+                // ─── Субагент: изолированный контекст для задачи ──
                 const task = String(parsed.arguments.task || '');
                 if (!task) {
                     toolOutput = 'Error: task is required';
@@ -681,6 +741,7 @@ export async function runAgentLoop(provider, registry, prompt, contextManager, p
                     messages,
                     questionPending: { question: `Approve: ${action}?`, choices: ['Yes', 'No'] },
                 };
+                // ─── MCP-инструменты ────────────────────────────────
             }
             else if (isBash && isMCPCommand(cmd)) {
                 const mcpCmd = parseMCPCommand(cmd);
@@ -694,11 +755,13 @@ export async function runAgentLoop(provider, registry, prompt, contextManager, p
                     toolOutput = 'Invalid MCP command. Format: mcp <server> <tool> [args_json]';
                     toolExitCode = 1;
                 }
+                // ─── Файловые инструменты (не bash) ─────────────────
             }
             else if (!isBash) {
                 const result = await registry.execute({ id: toolId, name: parsed.name, arguments: parsed.arguments });
                 toolOutput = result.stdout || result.stderr || '(no output)';
                 toolExitCode = result.exitCode;
+                // ─── Bash: выполнение shell-команд ──────────────────
             }
             else {
                 const result = await registry.execute({ id: toolId, name: 'bash', arguments: { cmd, timeout: parsed.arguments?.timeout ?? 120 } });
@@ -751,7 +814,7 @@ export async function runAgentLoop(provider, registry, prompt, contextManager, p
             else if (!isBash && parsed.name !== 'read_file') {
                 lastReadFile = null;
             }
-            // Syntax check after file write operations
+            // ─── Проверка синтаксиса после записи файлов ────────
             let hasSyntaxError = false;
             if (toolExitCode === 0) {
                 const isWriteOp = isBash
@@ -814,7 +877,7 @@ export async function runAgentLoop(provider, registry, prompt, contextManager, p
                                 pendingSyntaxError = '';
                             }
                         }
-                        // Auto-detect coding style from file content
+                        // Автодетекция стиля кодирования из содержимого файла
                         if (toolExitCode === 0 && filePath) {
                             try {
                                 const fullContent = readFileSync(join(process.cwd(), filePath), 'utf-8');