cli-surf 0.11.0 → 0.12.1

package/cli.js

@@ -14,10 +14,13 @@ import os from 'node:os';
 import path from 'node:path';
 import readline from 'node:readline/promises';
 import { stdin as input, stdout as output } from 'node:process';
+import { fileURLToPath } from 'node:url';
 import { normalizeOpusModelId, opusProviderModel } from './opusModels.js';
-import { Spinner, MdStream, usageCard, chatBanner, answerFooter, assistantHead, completer, chatHelp, paint, OPUS_MODEL_IDS, statusLabel, selectArrows, selectNumbered, canUseArrows, modelDisplayName, PICKABLE_MODEL_IDS, normModelKey, setAccentColor, defaultAccentHex, setCliLanguage, tr, isRussian, } from './cliUi.js';
-const VERSION = '0.11.0';
-const DEFAULT_SERVER = 'http://localhost:3001';
+import { Spinner, MdStream, usageCard, chatBanner, answerFooter, assistantHead, completer, chatHelp, paint, OPUS_MODEL_IDS, statusLabel, selectArrows, selectNumbered, canUseArrows, modelDisplayName, PICKABLE_MODEL_IDS, normModelKey, MODEL_HINTS, setAccentColor, defaultAccentHex, setCliLanguage, tr, isRussian, } from './cliUi.js';
+const VERSION = '0.12.1';
+// Production API used by fresh installations. Local development can still
+// override it with --server http://localhost:3001 or SURF_SERVER.
+const DEFAULT_SERVER = 'https://surf-app.xyz';
 const CONFIG_DIR = path.join(os.homedir(), '.surf-cli');
 const CONFIG_PATH = path.join(CONFIG_DIR, 'config.json');
 const DEFAULT_PERMISSION_MODE = 'important';
@@ -34,6 +37,7 @@ function loadConfig() {
             permissionMode: parsed.permissionMode === 'always' || parsed.permissionMode === 'never'
                 ? parsed.permissionMode
                 : DEFAULT_PERMISSION_MODE,
+            shell: typeof parsed.shell === 'string' && parsed.shell ? parsed.shell : undefined,
         };
     }
     catch {
@@ -185,6 +189,7 @@ function printHelp() {
   surf ask <текст...> [опции]                   Один вопрос и ответ
   surf chat [опции]                             Интерактивный чат (стриминг, история)
   surf get <url...> [--out путь] [--open]       Скачать вложения Opus (нужен тот же токен)
+  surf mcp [list|add|remove|test]               MCP-серверы для агента (как в Codex)
 
 Опции ask/chat:
   --server URL     Адрес API (или env SURF_SERVER, по умолчанию ${DEFAULT_SERVER})
@@ -192,6 +197,7 @@ function printHelp() {
   --no-stream      Не стримить, дождаться полного ответа
   --attach <path>  Прикрепить файл к вопросу (ask; в chat — команда /attach)
   --chat-id <N>    Писать в чат мессенджера N (по умолчанию без сохранения — расход лимита тот же)
+  --open           Автоматически открыть созданный файл (Excel, PDF и т.д.)
   --json           Вывести сырой JSON ответа
   --yes, -y        Не спрашивать разрешений в этом запуске
 
@@ -200,7 +206,7 @@ function printHelp() {
   --open           Открыть скачанное в программе по умолчанию
 
 Команды внутри chat:
-  /usage, /model [id], /permissions, /clear, /help, /logout, /exit, ! — задача с файлами
+  /usage, /model [id], /permissions, /open [файл], /get <url>, /clear, /help, /logout, /exit, ! — задача с файлами
 ` : `Surf Opus CLI v${VERSION} — terminal access to the same limits as the messenger.
 Usage is shared: the CLI uses /api/ai/process under the same user_id and writes
 to the same ai_token_usage table. What is spent in the terminal is visible in the messenger.
@@ -216,6 +222,7 @@ Usage:
   surf ask <text...> [options]               Ask one question
   surf chat [options]                        Interactive chat (streaming, history)
   surf get <url...> [--out path] [--open]    Download Opus attachments
+  surf mcp [list|add|remove|test]             MCP servers for the agent (like Codex)
 
 ask/chat options:
   --server URL     API address (or SURF_SERVER; default ${DEFAULT_SERVER})
@@ -223,6 +230,7 @@ ask/chat options:
   --no-stream      Wait for the complete response
   --attach <path>  Attach a file (use /attach in chat)
   --chat-id <N>    Write to messenger chat N (without persistence by default)
+  --open           Open created file automatically
   --json           Print the raw JSON response
   --yes, -y        Do not ask for agent permissions for this run
 
@@ -231,18 +239,20 @@ get options:
   --open           Open with the default application
 
 Chat commands:
-  /usage, /model [id], /permissions, /clear, /help, /logout, /exit, ! — task with files
+  /usage, /model [id], /permissions, /open [file], /get <url>, /clear, /help, /logout, /exit, ! — task with files
 `);
 }
 function printModels() {
     console.log(paint(tr('Модели Opus (лимит общий для всех моделей):', 'Opus models (the limit is shared by all models):'), 'gray'));
     for (const id of OPUS_MODEL_IDS) {
         const normalized = normalizeOpusModelId(id);
+        const hintObj = MODEL_HINTS[id];
+        const hint = hintObj ? ` [${tr(hintObj.ru, hintObj.en)}]` : '';
         if (id === 'auto') {
             console.log(`  ${paint('Auto', 'white')} ${paint(tr('(auto) — сама подбирает, по умолчанию', '(auto) — chooses automatically; default'), 'gray')} ${paint(`→ ${opusProviderModel(normalized)}`, 'gray')}`);
             continue;
         }
-        console.log(`  ${paint(modelDisplayName(id), 'white')} ${paint(`(${id})`, 'gray')} ${paint(`→ ${opusProviderModel(normalized)}`, 'gray')}`);
+        console.log(`  ${paint(modelDisplayName(id), 'white')} ${paint(`(${id})${hint}`, 'gray')} ${paint(`→ ${opusProviderModel(normalized)}`, 'gray')}`);
     }
     console.log(paint(tr('\nfree-план всегда отвечает дешёвой моделью; pro выбирает любую.', '\nThe free plan always uses an economy model; Pro can choose any.'), 'gray'));
     console.log(paint(tr('При исчерпании месячного лимита включается cheap-mode (GPT-5 Nano).', 'When the monthly limit is exhausted, cheap mode (GPT-5 Nano) is enabled.'), 'gray'));
@@ -420,11 +430,12 @@ async function uploadInlineAttachments(server, token, atts, live) {
     }
     return out;
 }
-async function postProcessStream(server, token, body, handlers, stream) {
+async function postProcessStream(server, token, body, handlers, stream, signal) {
     const res = await fetch(resolveUrl(server, '/api/ai/process'), {
         method: 'POST',
         headers: { 'Content-Type': 'application/json', Authorization: `Bearer ${token}` },
         body: JSON.stringify(stream ? { ...body, stream: true } : body),
+        signal,
     });
     if (!res.ok) {
         const payload = await res.json().catch(() => ({}));
@@ -481,47 +492,6 @@ async function postProcessStream(server, token, body, handlers, stream) {
         throw new Error(tr('Стрим оборвался без done', 'The stream ended without done'));
     return done;
 }
-function printRichPayload(payload, server) {
-    const webSearch = payload.webSearch;
-    if (webSearch?.sources?.length) {
-        console.log(`\n${paint(tr('— Источники веб-поиска:', '— Web search sources:'), 'accent')}`);
-        for (const s of webSearch.sources.slice(0, 8))
-            console.log(`  ${paint('•', 'accent')} ${s.title} — ${paint(s.url, 'blue')}`);
-    }
-    const images = payload.images;
-    if (images?.length) {
-        console.log(`\n${paint(tr('— Картинки:', '— Images:'), 'accent')}`);
-        for (const img of images)
-            console.log(`  ${paint('•', 'accent')} ${paint(resolveUrl(server, img.url), 'blue')}${img.alt ? paint(` (${img.alt})`, 'gray') : ''}`);
-    }
-    const attachments = payload.attachments;
-    if (attachments?.length) {
-        console.log(`\n${paint(tr('— Файлы:', '— Files:'), 'accent')}`);
-        for (const f of attachments)
-            console.log(`  ${paint('•', 'accent')} ${paint(f.name, 'white')}: ${paint(resolveUrl(server, f.url), 'blue')}`);
-        console.log(paint(tr('Скачать: surf get <url> [--open]', 'Download: surf get <url> [--open]'), 'gray'));
-    }
-    if (payload.map)
-        console.log(`\n${paint(tr('— К ответу приложена интерактивная карта (смотри в мессенджере).', '— An interactive map is attached to the reply (view it in the messenger).'), 'gray')}`);
-}
-function handleProcessError(err) {
-    const e = err;
-    if (e?.status === 429 && e.payload?.code === 'ai_token_limit') {
-        console.error(`\n${paint(tr('Лимит Opus исчерпан (общий с мессенджером).', 'The Opus limit is exhausted (shared with the messenger).'), 'red')}`);
-        const usage = e.payload?.usage;
-        if (usage)
-            console.error(usageCard(usage));
-        process.exitCode = 2;
-        return;
-    }
-    if (e?.status === 401) {
-        console.error(tr('Не авторизован: токен протух. Выполни: surf login', 'Unauthorized: the token expired. Run: surf login'));
-        process.exitCode = 1;
-        return;
-    }
-    console.error(tr(`Ошибка: ${e?.message || err}`, `Error: ${e?.message || err}`));
-    process.exitCode = 1;
-}
 /** Красивое имя: opus-file-<uuid>__Отчёт.xlsx → Отчёт.xlsx */
 function prettyFileName(urlPath) {
     const base = path.basename(urlPath.split('?')[0]) || 'file';
@@ -564,6 +534,102 @@ async function openWithDefaultApp(target) {
     child.on('error', () => { });
     child.unref();
 }
+/** Скачать вложение Opus и сохранить локально. */
+async function downloadAttachment(server, token, rawUrl, destFolder = process.cwd(), customName, autoOpen = false) {
+    const url = resolveUrl(server, rawUrl);
+    const res = await fetch(url, { headers: { Authorization: `Bearer ${token}` } });
+    if (!res.ok)
+        return null;
+    const urlPath = new URL(url).pathname;
+    const fallbackName = customName || prettyFileName(urlPath);
+    const name = fileNameFromDisposition(res.headers.get('content-disposition'), fallbackName);
+    let dest = path.join(destFolder, name);
+    try {
+        const stat = fs.existsSync(dest) ? fs.statSync(dest) : null;
+        if (stat?.isDirectory() || (!stat && !path.extname(dest))) {
+            dest = path.join(dest, name);
+        }
+    }
+    catch { /* ignore */ }
+    if (fs.existsSync(dest)) {
+        const ext = path.extname(name);
+        const baseName = path.basename(name, ext);
+        let counter = 1;
+        const dir = path.dirname(dest);
+        while (fs.existsSync(path.join(dir, `${baseName} (${counter})${ext}`))) {
+            counter += 1;
+        }
+        dest = path.join(dir, `${baseName} (${counter})${ext}`);
+    }
+    fs.mkdirSync(path.dirname(dest), { recursive: true });
+    const buffer = Buffer.from(await res.arrayBuffer());
+    fs.writeFileSync(dest, buffer);
+    if (autoOpen) {
+        await openWithDefaultApp(dest);
+    }
+    return { path: dest, size: buffer.length };
+}
+/** Вывод форматированного ответа с авто-скачиванием созданных файлов прямо в рабочую папку. */
+async function handleRichPayload(payload, server, token, autoOpen = false, destFolder = process.cwd()) {
+    const savedFiles = [];
+    const webSearch = payload.webSearch;
+    if (webSearch?.sources?.length) {
+        console.log(`\n${paint(tr('— Источники веб-поиска:', '— Web search sources:'), 'accent')}`);
+        for (const s of webSearch.sources.slice(0, 8))
+            console.log(`  ${paint('•', 'accent')} ${s.title} — ${paint(s.url, 'blue')}`);
+    }
+    const images = payload.images;
+    if (images?.length) {
+        console.log(`\n${paint(tr('— Картинки:', '— Images:'), 'accent')}`);
+        for (const img of images)
+            console.log(`  ${paint('•', 'accent')} ${paint(resolveUrl(server, img.url), 'blue')}${img.alt ? paint(` (${img.alt})`, 'gray') : ''}`);
+    }
+    const attachments = payload.attachments;
+    if (attachments?.length) {
+        console.log(`\n${paint(tr('— Созданные файлы:', '— Created files:'), 'accent')}`);
+        for (const f of attachments) {
+            if (token) {
+                try {
+                    const saved = await downloadAttachment(server, token, f.url, destFolder, f.name, autoOpen);
+                    if (saved) {
+                        savedFiles.push(saved.path);
+                        const rel = path.relative(process.cwd(), saved.path) || saved.path;
+                        const formatted = rel.startsWith('.') || path.isAbsolute(rel) ? rel : `./${rel}`;
+                        const sizeStr = saved.size < 1024 * 1024
+                            ? `${(saved.size / 1024).toFixed(1)} КБ`
+                            : `${(saved.size / (1024 * 1024)).toFixed(1)} МБ`;
+                        console.log(`  ${paint('✔', 'green')} ${paint(f.name, 'white', 'bold')} → ${paint(formatted, 'accent')} ${paint(`(${sizeStr})`, 'gray')}`);
+                        continue;
+                    }
+                }
+                catch { /* fallback to link below */ }
+            }
+            console.log(`  ${paint('•', 'accent')} ${paint(f.name, 'white')}: ${paint(resolveUrl(server, f.url), 'blue')}`);
+            console.log(paint(tr('Скачать: surf get <url> [--open]', 'Download: surf get <url> [--open]'), 'gray'));
+        }
+    }
+    if (payload.map)
+        console.log(`\n${paint(tr('— К ответу приложена интерактивная карта (смотри в мессенджере).', '— An interactive map is attached to the reply (view it in the messenger).'), 'gray')}`);
+    return savedFiles;
+}
+function handleProcessError(err) {
+    const e = err;
+    if (e?.status === 429 && e.payload?.code === 'ai_token_limit') {
+        console.error(`\n${paint(tr('Лимит Opus исчерпан (общий с мессенджером).', 'The Opus limit is exhausted (shared with the messenger).'), 'red')}`);
+        const usage = e.payload?.usage;
+        if (usage)
+            console.error(usageCard(usage));
+        process.exitCode = 2;
+        return;
+    }
+    if (e?.status === 401) {
+        console.error(tr('Не авторизован: токен протух. Выполни: surf login', 'Unauthorized: the token expired. Run: surf login'));
+        process.exitCode = 1;
+        return;
+    }
+    console.error(tr(`Ошибка: ${e?.message || err}`, `Error: ${e?.message || err}`));
+    process.exitCode = 1;
+}
 /**
  * Скачивание вложений Opus. /uploads отдают файлы только авторизованным
  * (Bearer-токен того же пользователя), поэтому обычная вставка ссылки
@@ -589,32 +655,17 @@ async function cmdGet(args) {
     if (!urls.length)
         throw new Error('Использование: surf get <url|/uploads/...> [--out путь] [--open]');
     for (const raw of urls) {
-        const url = resolveUrl(server, raw);
-        const res = await fetch(url, { headers: { Authorization: `Bearer ${token}` } });
-        if (!res.ok) {
-            console.error(`Не удалось скачать ${raw}: HTTP ${res.status}`);
+        const destFolder = outArg || process.cwd();
+        const saved = await downloadAttachment(server, token, raw, destFolder, undefined, open);
+        if (!saved) {
+            console.error(paint(tr(`Не удалось скачать ${raw}`, `Failed to download ${raw}`), 'red'));
             process.exitCode = 1;
             continue;
         }
-        const urlPath = new URL(url).pathname;
-        const name = fileNameFromDisposition(res.headers.get('content-disposition'), prettyFileName(urlPath));
-        let dest = outArg || path.join(process.cwd(), name);
-        try {
-            const stat = fs.existsSync(dest) ? fs.statSync(dest) : null;
-            if (stat?.isDirectory() || (!stat && !path.extname(dest))) {
-                dest = path.join(dest, name);
-            }
-        }
-        catch {
-            dest = path.join(process.cwd(), name);
-        }
-        fs.mkdirSync(path.dirname(dest), { recursive: true });
-        const buffer = Buffer.from(await res.arrayBuffer());
-        fs.writeFileSync(dest, buffer);
-        console.log(`Сохранено: ${dest} (${buffer.length} байт)`);
+        const rel = path.relative(process.cwd(), saved.path) || saved.path;
+        console.log(paint(`✔ ${tr('Сохранено:', 'Saved:')} ${rel} (${saved.size} байт)`, 'green'));
         if (open) {
-            await openWithDefaultApp(dest);
-            console.log(`Открыто: ${dest}`);
+            console.log(paint(`✔ ${tr('Открыто:', 'Opened:')} ${rel}`, 'green'));
         }
     }
 }
@@ -622,10 +673,11 @@ async function cmdGet(args) {
  * Общий цикл ответа: спиннер мышления со статусами → заголовок Opus →
  * построчный markdown-стрим. Спиннер пишет в stderr, ответ — в stdout.
  */
-async function streamAnswer(server, token, body, model, showHead) {
+async function streamAnswer(server, token, body, model, showHead, signal) {
     const spinner = new Spinner();
     const md = new MdStream();
     let headed = false;
+    let receivedDelta = false;
     const ensureHead = () => {
         if (headed)
             return;
@@ -642,11 +694,21 @@ async function streamAnswer(server, token, body, model, showHead) {
                 spinner.update(statusLabel(s));
             },
             onDelta: t => {
+                receivedDelta = true;
                 ensureHead();
                 process.stdout.write(md.push(t));
             },
-        }, true);
+            onReset: () => {
+                receivedDelta = false;
+            },
+        }, true, signal);
         ensureHead();
+        if (!receivedDelta) {
+            const resp = typeof payload?.response === 'string' ? payload.response : '';
+            if (resp) {
+                process.stdout.write(md.push(resp));
+            }
+        }
         const tail = md.flush();
         if (tail)
             process.stdout.write(tail);
@@ -658,16 +720,18 @@ async function streamAnswer(server, token, body, model, showHead) {
     }
 }
 async function cmdAsk(args) {
+    loadProjectEnv(process.cwd());
     const server = resolveServer(getArgValue(args, '--server'));
     const token = await ensureToken(server);
     const model = resolveModel(getArgValue(args, '--model', '-m'));
     const stream = !hasFlag(args, '--no-stream');
     const json = hasFlag(args, '--json');
+    const open = hasFlag(args, '--open');
     const chatIdRaw = getArgValue(args, '--chat-id');
     const chatId = chatIdRaw ? Number(chatIdRaw) : undefined;
     const attachPath = getArgValue(args, '--attach', '--file', '-f');
     // Простой сбор текста: всё после 'ask', кроме значений известных флагов.
-    const skip = new Set(['--model', '-m', '--attach', '--file', '-f', '--chat-id', '--server']);
+    const skip = new Set(['--model', '-m', '--attach', '--file', '-f', '--chat-id', '--server', '--open']);
     const words = [];
     const rest = args;
     for (let i = 0; i < rest.length; i += 1) {
@@ -682,12 +746,12 @@ async function cmdAsk(args) {
     }
     const text = words.join(' ').trim();
     if (!text && !attachPath)
-        throw new Error('Использование: surf ask <текст> [--model auto] [--attach файл]');
+        throw new Error('Использование: surf ask <текст> [--model auto] [--attach файл] [--open]');
     const attachments = attachPath ? [await uploadAttachment(server, token, attachPath)] : undefined;
     try {
         if (stream && !json) {
             const payload = await streamAnswer(server, token, { text: text || 'Опиши прикреплённое.', history: [], model, ...(chatId ? { chatId } : {}), ...(attachments ? { attachments } : {}) }, model, false);
-            printRichPayload(payload, server);
+            await handleRichPayload(payload, server, token, open);
         }
         else {
             const payload = await postProcessStream(server, token, { text: text || 'Опиши прикреплённое.', history: [], model, ...(chatId ? { chatId } : {}), ...(attachments ? { attachments } : {}) }, {}, false);
@@ -697,7 +761,7 @@ async function cmdAsk(args) {
             }
             const md = new MdStream();
             process.stdout.write(md.push(String(payload.response || '')) + md.flush() + '\n');
-            printRichPayload(payload, server);
+            await handleRichPayload(payload, server, token, open);
         }
         const u = await api(server, token, 'GET', '/api/ai/usage').catch(() => null);
         if (u && !json)
@@ -715,12 +779,16 @@ async function cmdChat(args) {
     const chatId = chatIdRaw ? Number(chatIdRaw) : undefined;
     const history = [];
     let pendingAttachments;
+    let lastDownloadedFile = null;
     // Агентные задачи с файлами — инлайн, в том же чате: свой контекст
     // инструментов и своя история диалогов с моделью-агентом.
-    // Заодно создаём папку пользовательских скиллов, если её нет.
+    // Заодно подгружаем .env проекта и создаём папку пользовательских скиллов.
+    loadProjectEnv(process.cwd());
     ensureUserSkillsDir();
-    let permissionMode = loadConfig().permissionMode;
-    const codeCtx = createToolContext(process.cwd(), hasFlag(args, '--yes', '-y'), permissionMode);
+    const cliCfg = loadConfig();
+    let permissionMode = cliCfg.permissionMode;
+    const codeCtx = createToolContext(process.cwd(), hasFlag(args, '--yes', '-y'), permissionMode, cliCfg.shell);
+    await initMcp(codeCtx);
     const agentHistory = [{ role: 'system', content: CODE_SYSTEM(codeCtx.cwd, process.platform) }];
     console.log(chatBanner({
         version: VERSION,
@@ -782,215 +850,318 @@ async function cmdChat(args) {
             rlClosed = true;
         }
     };
-    for (;;) {
-        const submitted = interactive
-            ? await promptMenuLine({ prompt: paint('› ', 'accent'), history: chatHistory, complete: completeChatLine, noArgCommands: CHAT_NO_ARG_COMMANDS })
-            : { line: await nextLine(), attachments: [] };
-        if (submitted.line === null)
-            break;
-        if (interactive && submitted.line.trim()) {
-            chatHistory.push(submitted.line.trim());
-            if (chatHistory.length > 200)
-                chatHistory.shift();
-            appendHistory(submitted.line);
+    let activeAbortController = null;
+    const onSigint = () => {
+        if (activeAbortController) {
+            activeAbortController.abort();
+            process.stdout.write(paint(tr('\n(прервано по Ctrl+C)\n', '\n(interrupted by Ctrl+C)\n'), 'yellow'));
         }
-        // Загружаем только вложения, чьи токены остались в строке
-        // (стёртые Backspace из текста не отправляем).
-        const liveTokens = new Set((submitted.line.match(/\[(image|file) \d+\]/g) ?? [])
-            .filter(t => submitted.attachments.some(a => a.token === t)));
-        const inlineUploads = liveTokens.size > 0
-            ? await uploadInlineAttachments(server, token, submitted.attachments, liveTokens)
-            : [];
-        pendingAttachments = [...(pendingAttachments || []), ...inlineUploads];
-        // Токены загруженных файлов вычищаем из текста.
-        let msg = submitted.line.trim();
-        if (inlineUploads.length > 0) {
-            for (const u of inlineUploads)
-                msg = msg.split(u.token).join('');
-            msg = msg.replace(/\s+/g, ' ').trim();
-        }
-        if (!msg) {
-            if (inlineUploads.length > 0)
-                console.log(paint(tr('(файлы прикреплены — напишите сообщение)', '(files attached — write a message)'), 'gray'));
-            rep();
-            continue;
-        }
-        if (msg === '/exit' || msg === '/quit')
-            break;
-        if (msg === '/logout') {
-            cmdLogout();
-            break;
-        }
-        if (msg === '/clear') {
-            history.length = 0;
-            agentHistory.length = 0;
-            agentHistory.push({ role: 'system', content: CODE_SYSTEM(codeCtx.cwd, process.platform) });
-            console.log(paint(tr('(история очищена)', '(history cleared)'), 'gray'));
-            rep();
-            continue;
-        }
-        if (msg === '/help') {
-            console.log(chatHelp());
-            rep();
-            continue;
+        else {
+            process.exit(0);
         }
-        if (msg === '/permissions') {
-            const res = await pickPermissionMode(permissionMode, () => nextLine());
-            if (res && res !== 'arrows') {
-                permissionMode = res;
-                codeCtx.permissionMode = res;
-                savePermissionMode(res);
-                console.log(`${paint(tr('Разрешения:', 'Permissions:'), 'gray')} ${paint(permissionModeLabel(res), 'white')}`);
+    };
+    process.on('SIGINT', onSigint);
+    try {
+        for (;;) {
+            const submitted = interactive
+                ? await promptMenuLine({ prompt: paint('› ', 'accent'), history: chatHistory, complete: completeChatLine, noArgCommands: CHAT_NO_ARG_COMMANDS })
+                : { line: await nextLine(), attachments: [] };
+            if (submitted.line === null)
+                break;
+            if (interactive && submitted.line.trim()) {
+                chatHistory.push(submitted.line.trim());
+                if (chatHistory.length > 200)
+                    chatHistory.shift();
+                appendHistory(submitted.line);
+            }
+            // Загружаем только вложения, чьи токены остались в строке
+            // (стёртые Backspace из текста не отправляем).
+            const liveTokens = new Set((submitted.line.match(/\[(image|file) \d+\]/g) ?? [])
+                .filter(t => submitted.attachments.some(a => a.token === t)));
+            const inlineUploads = liveTokens.size > 0
+                ? await uploadInlineAttachments(server, token, submitted.attachments, liveTokens)
+                : [];
+            pendingAttachments = [...(pendingAttachments || []), ...inlineUploads];
+            // Токены загруженных файлов вычищаем из текста.
+            let msg = submitted.line.trim();
+            if (inlineUploads.length > 0) {
+                for (const u of inlineUploads)
+                    msg = msg.split(u.token).join('');
+                msg = msg.replace(/\s+/g, ' ').trim();
+            }
+            if (!msg) {
+                if (inlineUploads.length > 0)
+                    console.log(paint(tr('(файлы прикреплены — напишите сообщение)', '(files attached — write a message)'), 'gray'));
                 rep();
                 continue;
             }
-            if (res === null) {
+            if (msg === '/exit' || msg === '/quit')
+                break;
+            if (msg === '/logout') {
+                cmdLogout();
+                break;
+            }
+            if (msg === '/clear') {
+                history.length = 0;
+                agentHistory.length = 0;
+                agentHistory.push({ role: 'system', content: CODE_SYSTEM(codeCtx.cwd, process.platform) });
+                console.log(paint(tr('(история очищена)', '(history cleared)'), 'gray'));
                 rep();
                 continue;
             }
-            const idx = await selectArrows(tr('Разрешения для coding-агента (↑↓ выбор, Enter — ok, Esc — отмена):', 'Coding-agent permissions (↑↓ choose, Enter — confirm, Esc — cancel):'), permissionOptions(permissionMode));
-            if (idx !== null) {
-                permissionMode = PERMISSION_OPTION_IDS[idx];
-                codeCtx.permissionMode = permissionMode;
-                savePermissionMode(permissionMode);
-                console.log(`${paint(tr('Разрешения:', 'Permissions:'), 'gray')} ${paint(permissionModeLabel(permissionMode), 'white')}`);
+            if (msg === '/help') {
+                console.log(chatHelp());
+                rep();
+                continue;
             }
-            rep();
-            continue;
-        }
-        if (msg === '/skills') {
-            printSkills(codeCtx.cwd);
-            rep();
-            continue;
-        }
-        if (msg === '/usage') {
-            try {
-                printUsage(await api(server, token, 'GET', '/api/ai/usage'));
+            if (msg === '/permissions') {
+                const res = await pickPermissionMode(permissionMode, () => nextLine());
+                if (res && res !== 'arrows') {
+                    permissionMode = res;
+                    codeCtx.permissionMode = res;
+                    savePermissionMode(res);
+                    console.log(`${paint(tr('Разрешения:', 'Permissions:'), 'gray')} ${paint(permissionModeLabel(res), 'white')}`);
+                    rep();
+                    continue;
+                }
+                if (res === null) {
+                    rep();
+                    continue;
+                }
+                const idx = await selectArrows(tr('Разрешения для coding-агента (↑↓ выбор, Enter — ok, Esc — отмена):', 'Coding-agent permissions (↑↓ choose, Enter — confirm, Esc — cancel):'), permissionOptions(permissionMode));
+                if (idx !== null) {
+                    permissionMode = PERMISSION_OPTION_IDS[idx];
+                    codeCtx.permissionMode = permissionMode;
+                    savePermissionMode(permissionMode);
+                    console.log(`${paint(tr('Разрешения:', 'Permissions:'), 'gray')} ${paint(permissionModeLabel(permissionMode), 'white')}`);
+                }
+                rep();
+                continue;
             }
-            catch (err) {
-                handleProcessError(err);
+            if (msg === '/skills') {
+                printSkills(codeCtx.cwd);
+                rep();
+                continue;
             }
-            rep();
-            continue;
-        }
-        if (msg === '/model' || msg.startsWith('/model ')) {
-            const res = await pickModel(msg, model, () => nextLine());
-            if (res && res !== 'arrows') {
-                model = res;
-                saveModel(model);
-                console.log(confirmModelLine(model));
+            if (msg === '/usage') {
+                try {
+                    printUsage(await api(server, token, 'GET', '/api/ai/usage'));
+                }
+                catch (err) {
+                    handleProcessError(err);
+                }
                 rep();
                 continue;
             }
-            if (res === null) {
+            if (msg === '/model' || msg.startsWith('/model ')) {
+                const res = await pickModel(msg, model, () => nextLine());
+                if (res && res !== 'arrows') {
+                    model = res;
+                    saveModel(model);
+                    console.log(confirmModelLine(model));
+                    rep();
+                    continue;
+                }
+                if (res === null) {
+                    rep();
+                    continue;
+                }
+                // Стрелочный пикер требует голый stdin: закрываем интерфейс,
+                // выбираем, создаём заново.
+                if (rl)
+                    rl.close();
+                const options = modelOptions(msg, model);
+                const idx = await selectArrows(tr('Модель — общий лимит для всех (↑↓ выбор, Enter — ok, Esc — отмена):', 'Model — shared limit for all (↑↓ choose, Enter — confirm, Esc — cancel):'), options);
+                if (!interactive) {
+                    rl = readline.createInterface({ input, output, completer, prompt: paint('› ', 'accent') });
+                    wireRl(rl);
+                }
+                rlClosed = false;
+                if (idx !== null) {
+                    model = normalizeOpusModelId(options[idx].id);
+                    saveModel(model);
+                    console.log(confirmModelLine(model));
+                }
                 rep();
                 continue;
             }
-            // Стрелочный пикер требует голый stdin: закрываем интерфейс,
-            // выбираем, создаём заново.
-            if (rl)
-                rl.close();
-            const options = modelOptions(msg, model);
-            const idx = await selectArrows(tr('Модель — общий лимит для всех (↑↓ выбор, Enter — ok, Esc — отмена):', 'Model — shared limit for all (↑↓ choose, Enter — confirm, Esc — cancel):'), options);
-            if (!interactive) {
-                rl = readline.createInterface({ input, output, completer, prompt: paint('› ', 'accent') });
-                wireRl(rl);
+            if (msg.startsWith('/open')) {
+                const target = msg.slice(5).trim() || lastDownloadedFile;
+                if (!target) {
+                    console.log(paint(tr('Укажите путь к файлу или скачайте файл: /open [файл]', 'Specify file path or download a file first: /open [file]'), 'yellow'));
+                }
+                else {
+                    const full = path.resolve(process.cwd(), target);
+                    if (!fs.existsSync(full)) {
+                        console.log(paint(tr(`Файл не найден: ${target}`, `File not found: ${target}`), 'red'));
+                    }
+                    else {
+                        console.log(paint(tr(`Открываю ${path.basename(full)}…`, `Opening ${path.basename(full)}…`), 'gray'));
+                        await openWithDefaultApp(full);
+                    }
+                }
+                rep();
+                continue;
             }
-            rlClosed = false;
-            if (idx !== null) {
-                model = normalizeOpusModelId(options[idx].id);
-                saveModel(model);
-                console.log(confirmModelLine(model));
+            if (msg.startsWith('/get')) {
+                const getUrl = msg.slice(4).trim();
+                if (!getUrl) {
+                    console.log(paint(tr('Использование: /get <url>', 'Usage: /get <url>'), 'yellow'));
+                }
+                else {
+                    try {
+                        const saved = await downloadAttachment(server, token, getUrl, process.cwd(), undefined, false);
+                        if (saved) {
+                            lastDownloadedFile = saved.path;
+                            const rel = path.relative(process.cwd(), saved.path) || saved.path;
+                            console.log(paint(`✔ ${tr('Сохранено:', 'Saved:')} ${rel} (${saved.size} байт)`, 'green'));
+                        }
+                    }
+                    catch (e) {
+                        console.error(paint(tr(`Ошибка скачивания: ${e.message}`, `Download error: ${e.message}`), 'red'));
+                    }
+                }
+                rep();
+                continue;
             }
-            rep();
-            continue;
-        }
-        if (msg.startsWith('/')) {
-            // Вызов скилла как slash-команды: /имя-скилла [текст задачи]
-            const skillName = msg.slice(1).split(/\s+/)[0]?.toLowerCase() ?? '';
-            const skillArgs = msg.slice(1 + skillName.length).trim();
-            const skill = skillName ? loadSkill(codeCtx.cwd, skillName) : null;
-            if (skill) {
-                const taskText = skillArgs || tr('Следуй инструкциям навыка.', 'Follow the skill instructions.');
-                console.log(paint(tr(`— навык ${skill.meta.name}: работаю…`, `— skill ${skill.meta.name}: working…`), 'gray'));
-                const skillTask = `<skill name="${skill.meta.name}">\n${skill.instructions}\n</skill>\n\n${tr('Задача пользователя:', 'User task:')} ${taskText}`;
-                const lastText = await runAgentTask(server, token, model, codeCtx, agentHistory, skillTask, 25);
-                history.push({ role: 'user', text: msg });
-                history.push({ role: 'ai', text: lastText.slice(0, 1500) || '(задача выполнена)' });
+            if (msg.startsWith('/')) {
+                // Вызов скилла как slash-команды: /имя-скилла [текст задачи]
+                const skillName = msg.slice(1).split(/\s+/)[0]?.toLowerCase() ?? '';
+                const skillArgs = msg.slice(1 + skillName.length).trim();
+                const skill = skillName ? loadSkill(codeCtx.cwd, skillName) : null;
+                if (skill) {
+                    const taskText = skillArgs || tr('Следуй инструкциям навыка.', 'Follow the skill instructions.');
+                    console.log(paint(tr(`— навык ${skill.meta.name}: работаю…`, `— skill ${skill.meta.name}: working…`), 'gray'));
+                    const skillTask = `<skill name="${skill.meta.name}">\n${skill.instructions}\n</skill>\n\n${tr('Задача пользователя:', 'User task:')} ${taskText}`;
+                    const abortCtrl = new AbortController();
+                    activeAbortController = abortCtrl;
+                    try {
+                        const lastText = await runAgentTask(server, token, model, codeCtx, agentHistory, skillTask, 25, abortCtrl.signal);
+                        if (!abortCtrl.signal.aborted) {
+                            history.push({ role: 'user', text: msg });
+                            history.push({ role: 'ai', text: lastText.slice(0, 1500) || '(задача выполнена)' });
+                        }
+                    }
+                    catch (err) {
+                        if (abortCtrl.signal.aborted || err.name === 'AbortError') {
+                            rep();
+                            continue;
+                        }
+                        handleProcessError(err);
+                    }
+                    finally {
+                        activeAbortController = null;
+                    }
+                    rep();
+                    continue;
+                }
+                console.log(paint(tr('Неизвестная команда. /help — список.', 'Unknown command. /help lists commands.'), 'gray'));
                 rep();
                 continue;
             }
-            console.log(paint(tr('Неизвестная команда. /help — список.', 'Unknown command. /help lists commands.'), 'gray'));
-            rep();
-            continue;
-        }
-        // Один режим на всё: похоже на задачу с файлами/кодом — агентный цикл
-        // с инструментами прямо здесь; «!» в начале форсирует. Вложенные файлы
-        // всегда идут обычным чатом.
-        const forceAgent = msg.startsWith('!');
-        if ((forceAgent || looksLikeCodeTask(msg)) && !pendingAttachments?.length) {
-            const taskText = (forceAgent ? msg.slice(1) : msg).trim();
-            if (!taskText) {
+            // Один режим на всё: похоже на задачу с файлами/кодом — агентный цикл
+            // с инструментами прямо здесь; «!» в начале форсирует. Вложенные файлы
+            // всегда идут обычным чатом.
+            const forceAgent = msg.startsWith('!');
+            if ((forceAgent || looksLikeCodeTask(msg)) && !pendingAttachments?.length) {
+                const taskText = (forceAgent ? msg.slice(1) : msg).trim();
+                if (!taskText) {
+                    rep();
+                    continue;
+                }
+                console.log(paint(tr('— агент: работаю с файлами…', '— agent: working with files…'), 'gray'));
+                const abortCtrl = new AbortController();
+                activeAbortController = abortCtrl;
+                try {
+                    const lastText = await runAgentTask(server, token, model, codeCtx, agentHistory, taskText, 25, abortCtrl.signal);
+                    if (!abortCtrl.signal.aborted) {
+                        history.push({ role: 'user', text: msg });
+                        history.push({ role: 'ai', text: lastText.slice(0, 1500) || '(задача выполнена)' });
+                    }
+                }
+                catch (err) {
+                    if (abortCtrl.signal.aborted || err.name === 'AbortError') {
+                        rep();
+                        continue;
+                    }
+                    handleProcessError(err);
+                }
+                finally {
+                    activeAbortController = null;
+                }
                 rep();
                 continue;
             }
-            console.log(paint(tr('— агент: работаю с файлами…', '— agent: working with files…'), 'gray'));
-            const lastText = await runAgentTask(server, token, model, codeCtx, agentHistory, taskText, 25);
-            history.push({ role: 'user', text: msg });
-            history.push({ role: 'ai', text: lastText.slice(0, 1500) || '(задача выполнена)' });
+            const attachments = pendingAttachments;
+            pendingAttachments = undefined;
+            const abortCtrl = new AbortController();
+            activeAbortController = abortCtrl;
+            try {
+                const payload = await streamAnswer(server, token, { text: msg, history: history.slice(-10), model, ...(chatId ? { chatId } : {}), ...(attachments?.length ? { attachments } : {}) }, model, true, abortCtrl.signal);
+                if (!abortCtrl.signal.aborted) {
+                    const savedFiles = await handleRichPayload(payload, server, token, false);
+                    if (savedFiles.length > 0) {
+                        lastDownloadedFile = savedFiles[savedFiles.length - 1];
+                    }
+                    history.push({ role: 'user', text: msg });
+                    history.push({ role: 'ai', text: String(payload.response || '') });
+                    const u = await api(server, token, 'GET', '/api/ai/usage').catch(() => null);
+                    const footer = answerFooter(modelDisplayName(model), u);
+                    if (footer)
+                        console.log(footer);
+                }
+            }
+            catch (err) {
+                if (abortCtrl.signal.aborted || err.name === 'AbortError') {
+                    rep();
+                    continue;
+                }
+                handleProcessError(err);
+                if (err.status === 429)
+                    break;
+            }
+            finally {
+                activeAbortController = null;
+            }
             rep();
-            continue;
-        }
-        const attachments = pendingAttachments;
-        pendingAttachments = undefined;
-        try {
-            const payload = await streamAnswer(server, token, { text: msg, history: history.slice(-10), model, ...(chatId ? { chatId } : {}), ...(attachments?.length ? { attachments } : {}) }, model, true);
-            printRichPayload(payload, server);
-            history.push({ role: 'user', text: msg });
-            history.push({ role: 'ai', text: String(payload.response || '') });
-            const u = await api(server, token, 'GET', '/api/ai/usage').catch(() => null);
-            const footer = answerFooter(modelDisplayName(model), u);
-            if (footer)
-                console.log(footer);
-        }
-        catch (err) {
-            handleProcessError(err);
-            if (err.status === 429)
-                break;
         }
-        rep();
+    }
+    finally {
+        process.removeListener('SIGINT', onSigint);
     }
     if (rl)
         rl.close();
+    closeMcpClients(codeCtx);
     console.log(paint(tr('Пока!', 'Bye!'), 'accent'));
 }
-/** Пул моделей для пикера: фильтр по префиксу/подстроке или весь список без auto. */
+/** Пул моделей для пикера: фильтр по префиксу/подстроке имени/id или весь список как в мессенджере. */
 function modelPool(msg) {
     const key = normModelKey(msg.slice('/model'.length).trim());
     const pool = key
-        ? PICKABLE_MODEL_IDS.filter(id => id.startsWith(key) || id.includes(key))
-        : PICKABLE_MODEL_IDS;
+        ? PICKABLE_MODEL_IDS.filter(id => id.startsWith(key) || id.includes(key) || normModelKey(modelDisplayName(id)).includes(key))
+        : [...PICKABLE_MODEL_IDS];
     if (key && pool.length === 0) {
         console.log(paint(tr(`Модель «${key}» не найдена. Выберите из списка:`, `Model “${key}” was not found. Choose from the list:`), 'yellow'));
     }
-    return pool.length > 0 ? pool : PICKABLE_MODEL_IDS;
+    return pool.length > 0 ? pool : [...PICKABLE_MODEL_IDS];
 }
 function modelOptions(msg, current) {
     const pool = modelPool(msg);
-    // Auto/fast/advanced обычно скрыты из ручного списка. Но если один из них
-    // уже выбран, он должен быть отмечен текущим: иначе Enter в пикере молча
-    // применяет первый видимый вариант (сейчас это GPT-5.6 Sol).
     const ids = !msg.slice('/model'.length).trim() && OPUS_MODEL_IDS.includes(current) && !pool.includes(current)
         ? [current, ...pool]
         : pool;
-    return ids.map(id => ({
-        id,
-        label: modelDisplayName(id),
-        current: id === current,
-    }));
+    return ids.map(id => {
+        const hintObj = MODEL_HINTS[id];
+        return {
+            id,
+            label: modelDisplayName(id),
+            hint: hintObj ? tr(hintObj.ru, hintObj.en) : undefined,
+            current: id === current,
+        };
+    });
 }
 import { promptMenuLine, loadHistory, appendHistory, completeChatLine, CHAT_NO_ARG_COMMANDS, looksLikeCodeTask, } from './cliPrompt.js';
-import { CODE_TOOLS, createToolContext, executeAgentTool, } from './cliTools.js';
+import { CODE_TOOLS, createToolContext, executeAgentTool, initMcp, closeMcpClients, loadProjectEnv, } from './cliTools.js';
 import { skillsCatalog, loadSkill, discoverSkills, ensureUserSkillsDir, } from './cliSkills.js';
 /** Печать установленных скиллов: имя, источник, описание. */
 function printSkills(cwd) {
@@ -1070,7 +1241,9 @@ async function pickModel(msg, current, readLine) {
     const key = normModelKey(msg.slice('/model'.length).trim());
     if (key && OPUS_MODEL_IDS.includes(key))
         return normalizeOpusModelId(key);
-    const pool = key ? PICKABLE_MODEL_IDS.filter(id => id.startsWith(key) || id.includes(key)) : PICKABLE_MODEL_IDS;
+    const pool = key
+        ? PICKABLE_MODEL_IDS.filter(id => id.startsWith(key) || id.includes(key) || normModelKey(modelDisplayName(id)).includes(key))
+        : PICKABLE_MODEL_IDS;
     if (key && pool.length === 1)
         return normalizeOpusModelId(pool[0]);
     if (canUseArrows())
@@ -1092,45 +1265,193 @@ Rules:
 - Never commit, push, publish or delete user data unless explicitly asked. Never create files unless needed for the task.
 - If the task is unclear or destructive, ask first instead of guessing.
 - Work until done or blocked; on blockers, clearly report what is missing.`;
-async function agentTurn(server, token, model, messages) {
-    const data = await api(server, token, 'POST', '/api/cli/agent', { model, messages, tools: CODE_TOOLS });
-    return { message: data.message, usage: data.usage };
+async function postAgentStream(server, token, body, handlers, stream, signal) {
+    const res = await fetch(resolveUrl(server, '/api/cli/agent'), {
+        method: 'POST',
+        headers: { 'Content-Type': 'application/json', Authorization: `Bearer ${token}` },
+        body: JSON.stringify(stream ? { ...body, stream: true } : body),
+        signal,
+    });
+    if (!res.ok) {
+        const payload = await res.json().catch(() => ({}));
+        const err = new Error(payload.error || `HTTP ${res.status}`);
+        err.status = res.status;
+        err.payload = payload;
+        throw err;
+    }
+    const contentType = res.headers.get('content-type') || '';
+    if (!stream || !contentType.includes('text/event-stream') || !res.body) {
+        return res.json();
+    }
+    const reader = res.body.getReader();
+    const decoder = new TextDecoder();
+    let carry = '';
+    let done = null;
+    const handleBlock = (block) => {
+        let event = 'message';
+        const lines = [];
+        for (const raw of block.split('\n')) {
+            const line = raw.replace(/\r$/, '');
+            if (line.startsWith('event:'))
+                event = line.slice(6).trim();
+            else if (line.startsWith('data:'))
+                lines.push(line.slice(5).trimStart());
+        }
+        if (!lines.length)
+            return;
+        const data = JSON.parse(lines.join('\n'));
+        if (event === 'delta' && typeof data.text === 'string')
+            handlers.onDelta?.(data.text);
+        else if (event === 'status' && typeof data.status === 'string')
+            handlers.onStatus?.(data.status);
+        else if (event === 'reset')
+            handlers.onReset?.();
+        else if (event === 'done')
+            done = data;
+        else if (event === 'error')
+            throw new Error(data.error || 'agent stream error');
+    };
+    for (;;) {
+        const { done: finished, value } = await reader.read();
+        if (finished)
+            break;
+        carry += decoder.decode(value, { stream: true });
+        const blocks = carry.split('\n\n');
+        carry = blocks.pop() || '';
+        for (const b of blocks)
+            handleBlock(b);
+    }
+    if (carry.trim())
+        handleBlock(carry);
+    if (!done)
+        throw new Error(tr('Стрим агента оборвался без done', 'Agent stream ended without done'));
+    return done;
+}
+function ensureCompactionNotice(history) {
+    if (history.length <= 2)
+        return;
+    if (history[2]?.role === 'user' && typeof history[2].content === 'string' && history[2].content.startsWith('[контекст сжат'))
+        return;
+    history.splice(2, 0, {
+        role: 'user',
+        content: '[контекст сжат: ранние промежуточные шаги и вывод инструментов удалены для экономии лимита]',
+    });
 }
-function trimAgentHistory(history) {
-    // system всегда первый; остальное — скользящее окно.
-    while (history.length > 41) {
-        const idx = history.findIndex((m, i) => i > 0 && m.role !== 'system');
-        if (idx < 0)
+export function trimAgentHistory(history, maxLimit = 41) {
+    // system всегда первый; начальное задание пользователя (индекс 1) сохраняем,
+    // чтобы агент не забывал исходную цель задачи при длинных цепочках шагов.
+    if (history.length <= maxLimit)
+        return;
+    while (history.length > maxLimit && history.length > 2) {
+        let startIdx = 2;
+        if (history.length > 3 &&
+            history[2].role === 'user' &&
+            typeof history[2].content === 'string' &&
+            history[2].content.startsWith('[контекст сжат')) {
+            startIdx = 3;
+        }
+        if (startIdx >= history.length)
             break;
-        history.splice(idx, 1);
+        const candidate = history[startIdx];
+        if (candidate.role === 'user') {
+            history.splice(startIdx, 1);
+            ensureCompactionNotice(history);
+            continue;
+        }
+        if (candidate.role === 'assistant') {
+            const toolCallIds = new Set((candidate.tool_calls || []).map(tc => tc.id).filter(Boolean));
+            let deleteCount = 1;
+            while (startIdx + deleteCount < history.length) {
+                const next = history[startIdx + deleteCount];
+                if (next.role === 'tool' && (toolCallIds.size === 0 || (next.tool_call_id && toolCallIds.has(next.tool_call_id)))) {
+                    deleteCount += 1;
+                }
+                else {
+                    break;
+                }
+            }
+            history.splice(startIdx, deleteCount);
+            ensureCompactionNotice(history);
+            continue;
+        }
+        // Если вдруг встретилось одинокое tool без assistant — удаляем его для валидности
+        if (candidate.role === 'tool') {
+            history.splice(startIdx, 1);
+            ensureCompactionNotice(history);
+            continue;
+        }
+        break;
     }
 }
-async function runAgentTask(server, token, model, ctx, history, userText, maxIters) {
+async function runAgentTask(server, token, model, ctx, history, userText, maxIters, signal) {
+    ctx.abortSignal = signal;
     history.push({ role: 'user', content: userText });
     trimAgentHistory(history);
     let emptyStreak = 0;
     let lastText = '';
     const skills = skillsCatalog(ctx.cwd);
+    const mcpLines = ctx.mcpTools.map(t => `- ${t.function.name}: ${t.function.description}`.slice(0, 200));
     const systemWithSkills = CODE_SYSTEM(ctx.cwd, process.platform) + (skills
         ? `\n\nУстановленные Agent Skills (модульные возможности):\n${skills}\n\nЕсли задача подходит под описание навыка — СНАЧАЛА вызови инструмент skill (action=read, name=<имя>) и строго следуй его инструкциям, включая запуск приложенных скриптов через bash. Актуальный список — через skill action=list.`
+        : '') + (mcpLines.length > 0
+        ? `\n\nПодключённые MCP-серверы, их инструменты уже доступны как mcp__server__tool:\n${mcpLines.join('\n')}\nИспользуй их когда уместно; это сторонние действия — подтверждение спросят отдельно.`
         : '');
     if (history[0]?.role === 'system')
         history[0] = { role: 'system', content: systemWithSkills };
     else
         history.unshift({ role: 'system', content: systemWithSkills });
     for (let iter = 1; iter <= maxIters; iter += 1) {
+        if (signal?.aborted)
+            break;
         const spinner = new Spinner();
         spinner.start(tr('Думаю…', 'Thinking…'));
         let turn;
+        let headed = false;
+        let receivedDelta = false;
+        const md = new MdStream();
+        const ensureHead = () => {
+            if (headed)
+                return;
+            headed = true;
+            spinner.stop();
+            process.stdout.write(`${assistantHead(modelDisplayName(model))}\n`);
+        };
         try {
-            turn = await agentTurn(server, token, model, history);
+            turn = await postAgentStream(server, token, { model, messages: history, tools: [...CODE_TOOLS, ...ctx.mcpTools] }, {
+                onStatus: s => {
+                    if (s === 'calling_tool') {
+                        if (headed) {
+                            const tail = md.flush();
+                            if (tail)
+                                process.stdout.write(tail);
+                            process.stdout.write('\n');
+                        }
+                        spinner.start(tr('Вызываю инструмент…', 'Calling tool…'));
+                    }
+                    else {
+                        spinner.update(statusLabel(s));
+                    }
+                },
+                onDelta: t => {
+                    receivedDelta = true;
+                    ensureHead();
+                    process.stdout.write(md.push(t));
+                },
+            }, true, signal);
         }
         catch (err) {
             spinner.stop();
+            if (signal?.aborted || err.name === 'AbortError') {
+                return lastText;
+            }
             handleProcessError(err);
             return lastText;
         }
-        spinner.stop();
+        finally {
+            spinner.stop();
+        }
+        if (signal?.aborted)
+            break;
         const msg = turn.message;
         history.push({
             role: 'assistant',
@@ -1139,9 +1460,14 @@ async function runAgentTask(server, token, model, ctx, history, userText, maxIte
         });
         if (msg.content) {
             lastText = msg.content;
-            const md = new MdStream();
-            process.stdout.write(`${assistantHead(modelDisplayName(model))}\n`);
-            process.stdout.write(md.push(msg.content) + md.flush() + '\n');
+            if (!receivedDelta) {
+                ensureHead();
+                process.stdout.write(md.push(msg.content));
+            }
+            const tail = md.flush();
+            if (tail)
+                process.stdout.write(tail);
+            process.stdout.write('\n');
         }
         const calls = msg.tool_calls ?? [];
         if (calls.length === 0) {
@@ -1159,6 +1485,8 @@ async function runAgentTask(server, token, model, ctx, history, userText, maxIte
         }
         emptyStreak = 0;
         for (const call of calls) {
+            if (signal?.aborted)
+                break;
             const rawArgs = call.function.arguments;
             const argsPreview = rawArgs.length > 200 ? `${rawArgs.slice(0, 200)}…` : rawArgs;
             console.log(`  ${paint('tool', 'gray')} ${paint(call.function.name, 'white')} ${paint(argsPreview, 'gray')}`);
@@ -1172,6 +1500,136 @@ async function runAgentTask(server, token, model, ctx, history, userText, maxIte
     }
     return lastText;
 }
+import { loadMcpConfig, loadMcpFile, writeMcpServer, removeMcpServer, connectMcpServer, userMcpPath, projectMcpPath, validMcpName, } from './cliMcp.js';
+async function cmdMcp(args) {
+    loadProjectEnv(process.cwd());
+    const sub = args[0];
+    const scopeArg = getArgValue(args, '--scope');
+    const scope = scopeArg === 'project' ? 'project' : 'user';
+    const scopeFile = scope === 'project' ? projectMcpPath(process.cwd()) : userMcpPath();
+    if (!sub || sub === 'list') {
+        const { servers, invalid } = loadMcpConfig(process.cwd());
+        const names = Object.keys(servers);
+        if (names.length === 0) {
+            console.log(paint(tr('MCP-серверов нет. Добавить: surf mcp add <имя> -- <команда> [аргументы]', 'No MCP servers. Add one: surf mcp add <name> -- <command> [args]'), 'gray'));
+            return;
+        }
+        const projectOnly = loadMcpFile(projectMcpPath(process.cwd())).servers;
+        for (const name of names) {
+            const cfg = servers[name];
+            const scopeMark = name in projectOnly ? 'project' : 'user';
+            const transportMark = cfg.url ? 'sse' : 'stdio';
+            const detail = cfg.url ? cfg.url : `${cfg.command ?? ''} ${(cfg.args ?? []).join(' ')}`.trim();
+            console.log(`  ${paint(name, 'white')} ${paint(`[${scopeMark}]`, 'gray')} ${paint(`[${transportMark}]`, 'blue')} ${paint(detail, 'gray')}`);
+        }
+        if (invalid > 0)
+            console.log(paint(tr(`Пропущено битых записей: ${invalid}`, `Skipped invalid entries: ${invalid}`), 'yellow'));
+        return;
+    }
+    if (sub === 'add') {
+        const name = args[1];
+        if (!name || !validMcpName(name))
+            throw new Error(tr('Нужно имя: surf mcp add <имя> ...', 'Name required: surf mcp add <name> ...'));
+        const urlArg = getArgValue(args, '--url');
+        const timeoutRaw = getArgValue(args, '--timeout');
+        if (urlArg) {
+            if (!/^https?:\/\/.+/i.test(urlArg))
+                throw new Error(tr('Некорректный URL. Нужен http:// или https://', 'Invalid URL. http:// or https:// required'));
+            const headers = {};
+            for (let i = 0; i < args.length; i += 1) {
+                if (args[i] === '--header' && i + 1 < args.length) {
+                    const h = args[i + 1];
+                    const colon = h.indexOf(':');
+                    const eq = h.indexOf('=');
+                    const sep = colon > 0 ? colon : eq;
+                    if (sep > 0) {
+                        headers[h.slice(0, sep).trim()] = h.slice(sep + 1).trim();
+                    }
+                }
+            }
+            const cfg = { url: urlArg };
+            if (Object.keys(headers).length > 0)
+                cfg.headers = headers;
+            if (timeoutRaw)
+                cfg.timeout = Math.min(600000, Math.max(1000, Number(timeoutRaw) || 60000));
+            writeMcpServer(scopeFile, name, cfg);
+            console.log(`${paint(tr('MCP-сервер добавлен (SSE):', 'MCP server added (SSE):'), 'green')} ${paint(name, 'white')} ${paint(`(${scope})`, 'gray')}`);
+            console.log(paint(tr('Проверь: surf mcp test <имя>', 'Verify: surf mcp test <name>').replace('<имя>', name).replace('<name>', name), 'gray'));
+            return;
+        }
+        const dash = args.indexOf('--');
+        if (dash < 0 || dash + 1 >= args.length)
+            throw new Error(tr('Нужна команда после -- или флаг --url: surf mcp add github -- npx -y ...', 'Command required after -- or use --url: surf mcp add github -- npx -y ...'));
+        const [command, ...cmdArgs] = args.slice(dash + 1);
+        const envVars = {};
+        for (let i = 0; i < args.length; i += 1) {
+            if (args[i] === '--env' && i + 1 < args.length && i + 1 < dash) {
+                const kv = args[i + 1];
+                const eq = kv.indexOf('=');
+                if (eq > 0)
+                    envVars[kv.slice(0, eq)] = kv.slice(eq + 1);
+            }
+        }
+        const cwdRaw = getArgValue(args, '--cwd');
+        const cfg = { command };
+        if (cmdArgs.length > 0)
+            cfg.args = cmdArgs;
+        if (Object.keys(envVars).length > 0)
+            cfg.env = envVars;
+        if (cwdRaw)
+            cfg.cwd = cwdRaw;
+        if (timeoutRaw)
+            cfg.timeout = Math.min(600000, Math.max(1000, Number(timeoutRaw) || 60000));
+        writeMcpServer(scopeFile, name, cfg);
+        console.log(`${paint(tr('MCP-сервер добавлен (stdio):', 'MCP server added (stdio):'), 'green')} ${paint(name, 'white')} ${paint(`(${scope})`, 'gray')}`);
+        console.log(paint(tr('Проверь: surf mcp test <имя>', 'Verify: surf mcp test <name>').replace('<имя>', name).replace('<name>', name), 'gray'));
+        return;
+    }
+    if (sub === 'remove') {
+        const name = args[1];
+        if (!name)
+            throw new Error(tr('Нужно имя: surf mcp remove <имя>', 'Name required: surf mcp remove <name>'));
+        const fromScope = scopeArg ? removeMcpServer(scopeFile, name) : (removeMcpServer(scopeFile, name) || removeMcpServer(scope === 'project' ? userMcpPath() : projectMcpPath(process.cwd()), name));
+        if (!fromScope)
+            throw new Error(tr(`Сервер «${name}» не найден`, `Server "${name}" not found`));
+        console.log(`${paint(tr('MCP-сервер удалён:', 'MCP server removed:'), 'green')} ${paint(name, 'white')}`);
+        return;
+    }
+    if (sub === 'test') {
+        const name = args[1];
+        if (!name)
+            throw new Error(tr('Нужно имя: surf mcp test <имя>', 'Name required: surf mcp test <name>'));
+        const { servers } = loadMcpConfig(process.cwd());
+        const cfg = servers[name];
+        if (!cfg)
+            throw new Error(tr(`Сервер «${name}» не найден`, `Server "${name}" not found`));
+        console.log(paint(tr('Подключаюсь…', 'Connecting…'), 'gray'));
+        const client = await connectMcpServer(name, cfg);
+        try {
+            if (client.tools.length === 0) {
+                console.log(paint(tr('Подключено, инструментов нет', 'Connected, no tools'), 'yellow'));
+            }
+            else {
+                console.log(`${paint(tr('Инструментов:', 'Tools:'), 'green')} ${client.tools.length}`);
+                for (const t of client.tools.slice(0, 30)) {
+                    console.log(`  ${paint(t.name, 'white')} ${paint((t.description || '').slice(0, 100), 'gray')}`);
+                }
+            }
+        }
+        finally {
+            client.close();
+        }
+        return;
+    }
+    console.log([
+        paint(tr('Использование:', 'Usage:'), 'white'),
+        `  surf mcp                                    ${tr('список серверов', 'list servers')}`,
+        `  surf mcp add <имя> --url <url> [--header "K: V" ...] [--timeout MS]`,
+        `  surf mcp add <имя> [--scope user|project] [--env K=V ...] [--timeout MS] [--cwd DIR] -- <команда> [аргументы]`,
+        `  surf mcp remove <имя> [--scope user|project]`,
+        `  surf mcp test <имя>`,
+    ].join('\n'));
+}
 async function main() {
     const [, , cmd, ...args] = process.argv;
     loadSavedAccent();
@@ -1226,6 +1684,10 @@ async function main() {
             await cmdGet(args);
             return;
         }
+        if (cmd === 'mcp') {
+            await cmdMcp(args);
+            return;
+        }
         console.error(tr(`Неизвестная команда: ${cmd}\n`, `Unknown command: ${cmd}\n`));
         printHelp();
         process.exitCode = 1;
@@ -1235,5 +1697,24 @@ async function main() {
         process.exitCode = 1;
     }
 }
-void main();
+const isMain = () => {
+    if (!process.argv[1])
+        return false;
+    try {
+        const thisFile = path.resolve(fileURLToPath(import.meta.url));
+        const runFile = path.resolve(process.argv[1]);
+        if (runFile === thisFile)
+            return true;
+        if (runFile.replace(/\.js$/, '.ts') === thisFile || thisFile.replace(/\.js$/, '.ts') === runFile)
+            return true;
+        const baseRun = path.basename(runFile);
+        return baseRun === 'surf' || baseRun === 'opus' || baseRun === 'cli.ts' || baseRun === 'cli.js';
+    }
+    catch {
+        return false;
+    }
+};
+if (isMain()) {
+    void main();
+}
 //# sourceMappingURL=cli.js.map