micro-models-agent 2.16.0 → 2.17.1

package/dist/tools/pipeline-run.js

@@ -1,167 +0,0 @@
-/** Тул прогона именованного YAML-пайплайна (DAG субагентов). */
-import { t } from "../i18n/index";
-import { PipelineEngine } from "../modules/pipelines/engine";
-import { PipelineParser } from "../modules/pipelines/parser";
-import { TemplateEngine } from "../modules/pipelines/template";
-import { Agent } from "../core/agent";
-import { ContextManager } from "../modules/context/manager";
-import { PluginManager } from "../modules/plugins/manager";
-import { HallucinationDetector } from "../modules/hallucination/detector";
-import { logSecurityBlock } from "../modules/security/audit-log";
-import { getSessionSecurityConfig } from "../modules/security/session-isolation";
-/** Максимум параллельных шагов / попыток шага. */
-const MAX_CONCURRENT = 3;
-const MAX_ATTEMPTS = 3;
-/** Прогоняет шаг пайплайна субагентом с ретраями (параметры/выходы — в промпт). */
-async function runStep(ctx, step, params, outputs) {
-    const prompt = TemplateEngine.render(step.prompt, params, outputs);
-    let lastError = "";
-    for (let attempt = 1; attempt <= MAX_ATTEMPTS; attempt++) {
-        try {
-            const subContextManager = new ContextManager(ctx.config.contextWindow, ctx.config.contextBudget);
-            const subPluginManager = new PluginManager();
-            const systemPrompt = {
-                content: `You are a pipeline step agent ("${step.agent}"). Complete the given task using the available tools.`,
-                priority: "critical",
-                essential: true,
-                estimatedTokens: 80,
-            };
-            const subDeps = {
-                config: ctx.config,
-                llmProvider: ctx.llmProvider,
-                toolExecutor: ctx.toolExecutor,
-                pluginManager: subPluginManager,
-                contextManager: subContextManager,
-                hallucinationDetector: new HallucinationDetector(ctx.baseDir, ctx.llmProvider),
-                logger: ctx.logger,
-                baseDir: ctx.baseDir,
-                scope: ctx.scope,
-                recursionDepth: (ctx.recursionDepth ?? 0) + 1,
-                promptBlocks: [systemPrompt],
-            };
-            const subAgent = new Agent(subDeps);
-            const result = await subAgent.run(prompt);
-            if (result.success) {
-                return { ok: true, output: result.text };
-            }
-            lastError = result.error || "no output";
-        }
-        catch (e) {
-            lastError = e.message;
-        }
-        await new Promise((r) => setTimeout(r, 500 * attempt));
-    }
-    return { ok: false, output: "", error: lastError };
-}
-/** Запускает DAG субагентов в порядке зависимостей. Параметры: name, yaml, params. */
-export const pipelineRunTool = {
-    name: "pipeline_run",
-    icon: "▶️",
-    description: "Run a named pipeline with YAML definition. Creates a DAG of sub-agents that execute in dependency order.",
-    tags: ["shell"],
-    parameters: {
-        type: "object",
-        properties: {
-            name: { type: "string", description: "Pipeline name" },
-            yaml: { type: "string", description: "Pipeline YAML definition with steps" },
-            params: { type: "object", description: "Template params for {key} placeholders" },
-        },
-        required: ["name", "yaml"],
-    },
-    handler: async (ctx, args) => {
-        const name = String(args.name || "");
-        const yaml = String(args.yaml || "");
-        const params = args.params || {};
-        if (!yaml) {
-            return { success: false, output: t("pipeline.invalid") };
-        }
-        if (!ctx.llmProvider || !ctx.toolExecutor) {
-            return {
-                success: false,
-                output: t("tool.pipeline_cannot_run"),
-            };
-        }
-        const securityConfig = ctx.sessionContext
-            ? getSessionSecurityConfig(ctx.config, ctx.sessionContext)
-            : ctx.config.security;
-        const maxDepth = securityConfig?.maxRecursionDepth ?? 3;
-        // Глубина — на SHARED-контексте исполнителя (вложенные субагенты/пайплайны
-        // читают её там); `ctx.recursionDepth` снапшотится раз и не инкрементится,
-        // поэтому старый гард не срабатывал. Зеркало subagent.ts.
-        const executor = ctx.toolExecutor;
-        const currentDepth = executor?.getRecursionDepth?.() ?? ctx.recursionDepth ?? 0;
-        if (currentDepth >= maxDepth) {
-            logSecurityBlock(ctx.sessionId, "bash_command", `Maximum recursion depth (${maxDepth}) exceeded`, name);
-            return {
-                success: false,
-                output: `[SECURITY BLOCKED] Maximum pipeline recursion depth (${maxDepth}) exceeded`,
-            };
-        }
-        // Свежий движок на вызов: module-level синглтон сбрасывался конкурентными
-        // вызовами (MoE-волны делят исполнитель) и портил состояние шагов.
-        const engine = new PipelineEngine();
-        executor?.setRecursionDepth?.(currentDepth + 1);
-        try {
-            const pipeline = PipelineParser.parse(yaml);
-            const order = engine.resolveDependencies(pipeline.steps);
-            const completed = new Set();
-            const outputs = {};
-            const logs = [];
-            const failed = new Set();
-            while (completed.size < pipeline.steps.length) {
-                const ready = engine
-                    .getReadySteps(pipeline.steps, completed)
-                    .filter((s) => !failed.has(s.id));
-                if (ready.length === 0) {
-                    if (failed.size > 0)
-                        break;
-                    throw new Error(t("pipeline.circular", { stepId: order.join(", ") }));
-                }
-                const batch = ready.slice(0, MAX_CONCURRENT);
-                const results = await Promise.all(batch.map((step) => runStep(ctx, step, params, outputs)));
-                for (let i = 0; i < batch.length; i++) {
-                    const step = batch[i];
-                    const result = results[i];
-                    if (result.ok) {
-                        completed.add(step.id);
-                        outputs[step.id] = { output: result.output };
-                        engine.setStepStatus(step.id, "done");
-                        logs.push(`  ✓ ${step.id}: ${result.output.split("\n")[0]}`);
-                    }
-                    else {
-                        failed.add(step.id);
-                        engine.setStepStatus(step.id, "failed");
-                        logs.push(`  ✗ ${step.id}: ${result.error}`);
-                    }
-                }
-                if (failed.size > 0)
-                    break;
-            }
-            if (failed.size > 0) {
-                return {
-                    success: false,
-                    output: t("tool.pipeline_failed", {
-                        name: pipeline.name,
-                        done: String(completed.size),
-                        total: String(pipeline.steps.length),
-                        logs: logs.join("\n"),
-                    }),
-                };
-            }
-            return {
-                success: true,
-                output: t("tool.pipeline_completed", {
-                    name: pipeline.name,
-                    steps: String(completed.size),
-                    logs: logs.join("\n"),
-                }),
-            };
-        }
-        catch (e) {
-            return { success: false, output: t("tool.pipeline_error", { error: e.message }) };
-        }
-        finally {
-            executor?.setRecursionDepth?.(currentDepth);
-        }
-    },
-};

package/dist/tools/preview.js

@@ -1,2 +0,0 @@
-/** Максимум строк в превью вывода тулов. */
-export const MAX_PREVIEW_LINES = 15;

package/dist/tools/process-ids.js

@@ -1,31 +0,0 @@
-/** Общие хелперы process_*-тулов: хинт без id, валидация + lookup. */
-import { processRegistry } from "../modules/processes";
-import { t } from "../i18n/index";
-/**
- * Общий ответ "id не дан" для process_*-тулов: хинт использования плюс
- * известные сейчас id (или пометка пустого реестра). Одна копия, чтобы
- * process-kill/log/wait не расходились.
- */
-export function missingProcessIdHint() {
-    const ids = processRegistry.list().map((p) => p.id);
-    const listPart = ids.length
-        ? `\n${t("proc.list_header")}: ${ids.join(", ")}`
-        : `\n${t("proc.missing_id_list")}`;
-    return `${t("proc.missing_id")}${listPart}`;
-}
-/**
- * Общая валидация id + lookup в реестре для process_*-тулов. Возвращает запись
- * либо `{ ok: false, output }` для прямого возврата (нет id — хинт,
- * неизвестный id — not-found).
- */
-export function lookupProcess(args) {
-    if (args.id === undefined || String(args.id).trim() === "") {
-        return { ok: false, output: missingProcessIdHint() };
-    }
-    const id = String(args.id);
-    const entry = processRegistry.get(id);
-    if (!entry) {
-        return { ok: false, output: t("proc.not_found", { id }) };
-    }
-    return { ok: true, id, entry };
-}

package/dist/tools/process-kill.js

@@ -1,33 +0,0 @@
-import { processRegistry } from "../modules/processes";
-import { t } from "../i18n/index";
-import { lookupProcess } from "./process-ids";
-/** Останавливает фоновый процесс по id из bash/process_list. */
-export const processKillTool = {
-    name: "process_kill",
-    icon: "⛔",
-    description: "Stop a background process started via bash (dev server, watcher). Kills the whole process tree (children included). Use the id returned by bash or process_list.",
-    tags: ["shell"],
-    parameters: {
-        type: "object",
-        properties: {
-            id: { type: "string", description: "Process id from bash output or process_list" },
-        },
-        required: ["id"],
-    },
-    handler: async (_ctx, args) => {
-        // Без id отвечаем использованием: голое "not found: undefined" не
-        // подсказывает верный формат.
-        const found = lookupProcess(args);
-        if (!found.ok)
-            return { success: false, output: found.output };
-        const { id, entry } = found;
-        const killed = processRegistry.kill(id);
-        if (!killed) {
-            return { success: false, output: t("proc.kill_failed", { id }) };
-        }
-        return {
-            success: true,
-            output: t("proc.killed", { id, pid: entry.pid }),
-        };
-    },
-};

package/dist/tools/process-list.js

@@ -1,38 +0,0 @@
-import { processRegistry } from "../modules/processes";
-import { t } from "../i18n/index";
-/** Показывает фоновые процессы сессии с хинтом управления. */
-export const processListTool = {
-    name: "process_list",
-    icon: "📊",
-    description: "List background processes started via the bash tool (dev servers, watchers, long-running commands). Shows id, pid, command, status, and recent output. Use with process_log and process_kill to inspect or stop them.",
-    tags: ["shell"],
-    parameters: {
-        type: "object",
-        properties: {},
-    },
-    handler: async (ctx) => {
-        const list = processRegistry.list(ctx.sessionId);
-        if (list.length === 0) {
-            return { success: true, output: t("proc.none") };
-        }
-        const statusLabel = (status) => {
-            if (status === "running")
-                return t("proc.status_running");
-            if (status === "exited")
-                return t("proc.status_exited");
-            return t("proc.status_killed");
-        };
-        const lines = [`${t("proc.list_header")} (${list.length}):`];
-        for (const entry of list) {
-            const tail = entry.log.length > 0 ? entry.log[entry.log.length - 1] : "";
-            const detail = tail ? ` — ${tail.slice(0, 80)}${tail.length > 80 ? "…" : ""}` : "";
-            lines.push(`  ${entry.id}  PID ${entry.pid}  ${statusLabel(entry.status)}  ${entry.command}${detail}`);
-        }
-        lines.push(`\n${t("proc.hint", {
-            list: "process_list",
-            log: "process_log",
-            kill: "process_kill",
-        })}`);
-        return { success: true, output: lines.join("\n") };
-    },
-};

package/dist/tools/process-log.js

@@ -1,49 +0,0 @@
-import { processRegistry } from "../modules/processes";
-import { t } from "../i18n/index";
-import { MAX_PREVIEW_LINES } from "./preview";
-import { lookupProcess } from "./process-ids";
-const DEFAULT_TAIL = MAX_PREVIEW_LINES;
-/** Потолок из описания тула; тул вне усечения по бюджету. */
-const MAX_TAIL = 300;
-/** Показывает буферизированный вывод фонового процесса (последние N строк). */
-export const processLogTool = {
-    name: "process_log",
-    icon: "📜",
-    description: `Show the buffered output of a background process started via bash. Shows the last ${DEFAULT_TAIL} lines by default. Use after starting a dev server to verify it came up without errors, and while it runs to check its state. For a finite task that should complete, prefer process_wait over polling this tool.`,
-    tags: ["shell"],
-    boundedOutput: true,
-    parameters: {
-        type: "object",
-        properties: {
-            id: { type: "string", description: "Process id from bash output or process_list" },
-            tail: {
-                type: "number",
-                description: `Number of trailing lines to show (default: ${DEFAULT_TAIL}, max 300)`,
-            },
-        },
-        required: ["id"],
-    },
-    handler: async (_ctx, args) => {
-        const found = lookupProcess(args);
-        if (!found.ok)
-            return { success: false, output: found.output };
-        const { id, entry } = found;
-        const status = entry.status === "running"
-            ? t("proc.status_running")
-            : entry.status === "exited"
-                ? t("proc.status_exited")
-                : t("proc.status_killed");
-        const tail = Math.min(MAX_TAIL, Math.max(1, typeof args.tail === "number" ? Math.floor(args.tail) : DEFAULT_TAIL));
-        const log = processRegistry.getLog(id, tail);
-        if (!log) {
-            return {
-                success: true,
-                output: `${t("proc.log_header", { id, status })} ${t("proc.log_empty")}`,
-            };
-        }
-        return {
-            success: true,
-            output: `${t("proc.log_header", { id, status })}\n${log}`,
-        };
-    },
-};

package/dist/tools/process-wait.js

@@ -1,63 +0,0 @@
-import { processRegistry } from "../modules/processes";
-import { t } from "../i18n/index";
-import { lookupProcess } from "./process-ids";
-import { PROCESS_WAIT_DEFAULT_MS as DEFAULT_WAIT_MS, PROCESS_WAIT_MAX_MS as MAX_WAIT_MS, } from "../config/timeouts";
-/**
- * Дефолтное ожидание: хватает на типичный тест/билд, но в пределах таймаута
- * исполнителя. `timeoutMs` тула даёт запас под явное долгое ожидание
- * (кламп MAX_WAIT_MS).
-  */
-const DEFAULT_TAIL = 20;
-const MAX_TAIL = 100;
-/** Ждёт выхода процесса до timeoutMs; отчитывается кодом и хвостом вывода. */
-export const processWaitTool = {
-    name: "process_wait",
-    icon: "⏳",
-    description: "Wait for a background process started via bash to finish, instead of polling process_log or sleeping (ping/timeout/sleep commands). Blocks up to timeoutMs, then reports whether the process exited (with its exit code and recent output) or is still running. For dev servers/watchers that never exit, use process_log to inspect and process_kill to stop them.",
-    tags: ["shell"],
-    boundedOutput: true,
-    timeoutMs: 120000,
-    parameters: {
-        type: "object",
-        properties: {
-            id: { type: "string", description: "Process id from bash output or process_list" },
-            timeoutMs: {
-                type: "number",
-                description: `How long to wait in milliseconds (default: ${DEFAULT_WAIT_MS}, max ${MAX_WAIT_MS})`,
-            },
-            tail: {
-                type: "number",
-                description: `Number of trailing output lines to include (default: ${DEFAULT_TAIL}, max ${MAX_TAIL})`,
-            },
-        },
-        required: ["id"],
-    },
-    handler: async (_ctx, args) => {
-        const found = lookupProcess(args);
-        if (!found.ok)
-            return { success: false, output: found.output };
-        const { id } = found;
-        const waitMs = Math.min(MAX_WAIT_MS, Math.max(1000, typeof args.timeoutMs === "number" ? Math.floor(args.timeoutMs) : DEFAULT_WAIT_MS));
-        const started = Date.now();
-        await processRegistry.waitForExit(id, waitMs);
-        const elapsed = Date.now() - started;
-        const entry = processRegistry.get(id);
-        if (!entry) {
-            return { success: false, output: t("proc.not_found", { id }) };
-        }
-        const tail = Math.min(MAX_TAIL, Math.max(1, typeof args.tail === "number" ? Math.floor(args.tail) : DEFAULT_TAIL));
-        const log = processRegistry.getLog(id, tail);
-        const logPart = log ? `\n${log}` : `\n${t("proc.log_empty")}`;
-        if (entry.status !== "running") {
-            const status = entry.status === "exited" ? t("proc.status_exited") : t("proc.status_killed");
-            return {
-                success: true,
-                output: `${t("proc.wait_exited", { id, ms: elapsed, status, code: entry.exitCode ?? "?" })}${logPart}`,
-            };
-        }
-        return {
-            success: true,
-            output: `${t("proc.wait_running", { id, ms: elapsed })}\n${t("proc.wait_hint", { id })}${logPart}`,
-        };
-    },
-};

package/dist/tools/prompt-io.js

@@ -1,29 +0,0 @@
-/** Терминал-независимая поверхность промпта для интерактивных тулов. */
-import { formatMenu, choicePrompt, parseSelection, CUSTOM_INDEX, } from "./user-input";
-import { t } from "../i18n/index";
-/** Собирает PromptIO из инжектируемых ask/print (тестируемо, без терминала). */
-export function createPromptIO(deps) {
-    return {
-        async askText(question) {
-            return (await deps.ask(`${question} `)).trim();
-        },
-        async askChoice(question, options, opts = {}) {
-            const multiple = opts.multiple ?? false;
-            const entryCount = options.length + (opts.allowCustom ? 1 : 0);
-            // Выбирать нечего (и кастома нет) — parseSelection не сойдётся никогда,
-            // поэтому выходим без печати мёртвого меню и вечного цикла.
-            if (entryCount === 0)
-                return [];
-            const customEntry = options.length;
-            deps.print(formatMenu(question, options, opts));
-            for (;;) {
-                const answer = await deps.ask(choicePrompt(entryCount, multiple));
-                const parsed = parseSelection(answer, entryCount, multiple);
-                if (parsed) {
-                    return parsed.map((i) => (opts.allowCustom && i === customEntry ? CUSTOM_INDEX : i));
-                }
-                deps.print(t("tool.user_input.invalid"));
-            }
-        },
-    };
-}