@getxflow/cli 0.1.4 → 0.1.7

package/README.md

@@ -24,9 +24,11 @@ xflow publish
 | `functions list` / `functions deploy` | облачные функции проекта из `functions/<имя>/index.ts` |
 | `functions invoke` / `functions logs` | вызвать функцию, посмотреть её падения со стеком |
 | `schedules list` / `set` / `rm` | запуск функций по времени (таймер-триггеры) |
+| `env` / `env check` / `env set` | переменные окружения функций, значения наружу не отдаются |
 | `logs` | ошибки выложенного приложения в браузере |
 | `projects list` / `projects get` / `open` | проекты организации и адреса приложения |
 | `skills` | инструкция о платформе для ИИ-агента (формат [Agent Skills](https://agentskills.io)) |
+| `mcp install` | подключить агента к платформе напрямую, без терминала |
 
 Справка по команде: `xflow help <команда>`.
 
@@ -34,5 +36,9 @@ xflow publish
 рядом описание платформы, которое Claude Code, Codex и OpenClaw подхватывают сами, когда задача
 касается XFlow. Ваши `AGENTS.md` и `CLAUDE.md` команда не трогает.
 
+`xflow mcp install` подключает агента к платформе напрямую: база, миграции, функции, расписания,
+переменные и версии становятся его инструментами, без разбора вывода команд. Код, сборка и выкладка
+остаются в CLI.
+
 Ключ хранится в `~/.xflow/credentials.json`, конфигурация проекта — в `xflow.json`.
 Для CI передайте ключ переменной `XFLOW_TOKEN`.

package/dist/api.js

@@ -18,12 +18,15 @@ class ApiError extends Error {
     code;
     status;
     hint;
-    constructor(message, code, status, hint) {
+    /** Разбор отказа, если он есть: например, нарушения, из-за которых не пошла сборка. */
+    issues;
+    constructor(message, code, status, hint, issues) {
         super(message);
         this.name = 'ApiError';
         this.code = code;
         this.status = status;
         this.hint = hint;
+        this.issues = issues;
     }
 }
 exports.ApiError = ApiError;
@@ -94,7 +97,7 @@ async function readError(response) {
     const text = await response.text().catch(() => '');
     try {
         const parsed = JSON.parse(text);
-        return new ApiError(parsed.error || `Запрос отклонён (${response.status})`, parsed.code || 'unknown', response.status, parsed.hint);
+        return new ApiError(parsed.error || `Запрос отклонён (${response.status})`, parsed.code || 'unknown', response.status, parsed.hint, parsed.issues);
     }
     catch {
         return new ApiError(`Запрос отклонён (${response.status})`, 'unknown', response.status, text.slice(0, 200) || undefined);

package/dist/args.js

@@ -20,12 +20,14 @@ const BOOLEAN_FLAGS = new Set([
     'json',
     'help',
     'version',
-    'open',
+    'global',
+    'live',
     'no-push',
     'skip-build',
     'all',
     'dry-run',
     'allow-destructive',
+    'show-token',
 ]);
 function parseArgs(argv) {
     const words = [];

package/dist/bin.js

@@ -12,8 +12,10 @@ const version_1 = require("./version");
 const auth_1 = require("./commands/auth");
 const projects_1 = require("./commands/projects");
 const db_1 = require("./commands/db");
+const env_1 = require("./commands/env");
 const functions_1 = require("./commands/functions");
 const logs_1 = require("./commands/logs");
+const mcp_1 = require("./commands/mcp");
 const schedules_1 = require("./commands/schedules");
 const skills_1 = require("./commands/skills");
 const sources_1 = require("./commands/sources");
@@ -47,9 +49,6 @@ async function run(args) {
         case 'link':
             await (0, projects_1.link)(rest);
             return;
-        case 'open':
-            await (0, projects_1.open)(rest);
-            return;
         case 'projects':
             if (second === 'get') {
                 await (0, projects_1.get)({ ...args, words: args.words.slice(2) });
@@ -63,6 +62,12 @@ async function run(args) {
         case 'skills':
             (0, skills_1.skills)(rest);
             return;
+        case 'mcp':
+            if (second === undefined || second === 'install') {
+                await (0, mcp_1.mcpInstall)(rest);
+                return;
+            }
+            throw new errors_1.CliError(`Неизвестная команда: mcp ${second}`, 'Есть install');
         case 'functions':
             if (second === 'deploy') {
                 await (0, functions_1.functionsDeploy)(rest);
@@ -84,6 +89,24 @@ async function run(args) {
         case 'logs':
             await (0, logs_1.logs)(rest);
             return;
+        case 'env':
+            if (second === 'set') {
+                await (0, env_1.envSet)(rest);
+                return;
+            }
+            if (second === 'rm' || second === 'remove') {
+                await (0, env_1.envRemove)(rest);
+                return;
+            }
+            if (second === 'check') {
+                await (0, env_1.envCheck)();
+                return;
+            }
+            if (second === undefined || second === 'list' || second === 'pull') {
+                await (0, env_1.envList)();
+                return;
+            }
+            throw new errors_1.CliError(`Неизвестная команда: env ${second}`, 'Есть list, check, set и rm');
         case 'schedules':
             if (second === 'set') {
                 await (0, schedules_1.schedulesSet)(rest);

package/dist/commands/auth.js

@@ -3,11 +3,11 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.login = login;
 exports.logout = logout;
 exports.whoami = whoami;
+const node_os_1 = require("node:os");
 const api_1 = require("../api");
 const config_1 = require("../config");
 const credentials_1 = require("../credentials");
 const errors_1 = require("../errors");
-const open_url_1 = require("../open-url");
 const session_1 = require("../session");
 const ui_1 = require("../ui");
 function localConfig() {
@@ -31,13 +31,20 @@ const sleep = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
 async function login() {
     const config = localConfig();
     const client = (0, session_1.anonymous)(config);
-    const start = await (0, api_1.apiJson)(client, '/api/v1/auth/device', { method: 'POST' });
+    // Имя машины уходит на сервер и становится названием ключа: иначе в списке
+    // доступов лежат одинаковые строки и непонятно, какой компьютер отзывать.
+    const start = await (0, api_1.apiJson)(client, '/api/v1/auth/device', {
+        method: 'POST',
+        body: { client_name: (0, node_os_1.hostname)() },
+    });
     (0, ui_1.note)('');
     (0, ui_1.note)(`  Код подтверждения: ${(0, ui_1.bold)(start.user_code)}`);
-    (0, ui_1.note)(`  Страница входа:    ${start.verification_uri}`);
+    (0, ui_1.note)(`  Компьютер:         ${(0, node_os_1.hostname)()}`);
+    (0, ui_1.note)(`  Ссылка для входа:  ${start.verification_uri_complete}`);
     (0, ui_1.note)('');
-    (0, ui_1.step)('Открываю браузер, код там надо сверить с показанным выше');
-    (0, open_url_1.openUrl)(start.verification_uri_complete);
+    // Браузер не открываем сами: команду часто запускает агент, и всплывшее окно
+    // забирает у человека внимание, не объяснив, что он подтверждает.
+    (0, ui_1.step)('Откройте ссылку и сверьте код на странице с показанным выше');
     const deadline = Date.now() + start.expires_in * 1000;
     let intervalMs = Math.max(start.interval, 1) * 1000;
     for (;;) {
@@ -68,9 +75,6 @@ async function login() {
             projectId: poll.project_id,
         });
         (0, ui_1.ok)(`Вход выполнен, ключ сохранён для ${client.apiUrl}`);
-        if (poll.project_id) {
-            (0, ui_1.note)((0, ui_1.dim)(`  Ключ выдан на проект ${poll.project_id}: другие проекты им недоступны`));
-        }
         return;
     }
 }
@@ -89,7 +93,6 @@ async function whoami() {
     const me = await (0, api_1.apiJson)(client, '/api/v1/me');
     (0, ui_1.out)(`Организация: ${me.organization.name ?? me.organization.id}`);
     (0, ui_1.out)(`Ключ:        xfk_${me.key.prefix}… (${me.key.scopes.join(', ')})`);
-    (0, ui_1.out)(`Проект ключа: ${me.key.project_id ?? 'вся организация'}`);
     (0, ui_1.out)(`Платформа:   ${client.apiUrl}`);
     if (process.env.XFLOW_TOKEN) {
         (0, ui_1.note)((0, ui_1.dim)('  Ключ взят из XFLOW_TOKEN, сохранённый в ~/.xflow не используется'));

package/dist/commands/deploy.js

@@ -4,45 +4,60 @@ exports.deploy = deploy;
 exports.publish = publish;
 exports.rollback = rollback;
 exports.deployments = deployments;
-const node_child_process_1 = require("node:child_process");
-const node_path_1 = require("node:path");
 const api_1 = require("../api");
 const args_1 = require("../args");
 const config_1 = require("../config");
 const errors_1 = require("../errors");
 const session_1 = require("../session");
-const tree_1 = require("../tree");
-const zip_1 = require("../zip");
 const ui_1 = require("../ui");
-const functions_1 = require("./functions");
 const sources_1 = require("./sources");
-/** Потолок артефакта на сервере. */
-const MAX_ARTIFACT_BYTES = 100 * 1024 * 1024;
+const sleep = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
 /**
- * Запустить сборку проекта.
+ * Потолок ожидания сборки в терминале. Чуть больше, чем срок, после которого
+ * платформа закрывает молчащую сборку: так разработчик увидит внятный отказ, а
+ * не «идёт дольше ожидаемого» на сборке, которую уже похоронили.
+ */
+const WAIT_LIMIT_MS = 16 * 60_000;
+/**
+ * Показать, чем проект не подошёл платформе.
  *
- * Через оболочку: команда задана разработчиком в xflow.json (`npm run build`),
- * и разбирать её самим значит спорить с тем, что он написал. Вывод идёт прямо
- * в терминал, поэтому кодировки и прогресс-бары выглядят как обычно.
+ * Печатаем весь список: правила известны заранее (скилл xflow), а узнавать их по
+ * одному через повторные запуски значит терять круг на каждое нарушение.
  */
-function runBuild(command, cwd) {
-    return new Promise((done, reject) => {
-        const child = (0, node_child_process_1.spawn)(command, { cwd, shell: true, stdio: 'inherit' });
-        child.on('error', (e) => reject(new errors_1.CliError(`Не удалось запустить сборку: ${e.message}`)));
-        child.on('close', (code) => {
-            if (code === 0) {
-                done();
-                return;
-            }
-            reject(new errors_1.CliError(`Сборка завершилась с кодом ${code}`, 'Деплой остановлен: на сервер уходит только то, что собралось'));
-        });
-    });
+function reportIssues(e) {
+    const issues = e.issues ?? [];
+    for (const issue of issues) {
+        const where = issue.file ? `${issue.file}${issue.lines?.length ? `:${issue.lines.join(', ')}` : ''}` : '';
+        (0, ui_1.out)(`  ${(0, ui_1.bold)(issue.code)} ${where}`);
+        (0, ui_1.note)((0, ui_1.dim)(`    ${issue.message}`));
+    }
+    throw new errors_1.CliError(e.message, e.hint);
+}
+/**
+ * Дождаться конца сборки, печатая фазы.
+ *
+ * Платформа отвечает на запуск сразу и не держит соединение: сборка живёт в
+ * песочнице и переживает перезапуск платформы, поэтому её состояние забирается
+ * опросом, а не потоком.
+ */
+async function waitForBuild(client, projectId, started) {
+    const deadline = Date.now() + WAIT_LIMIT_MS;
+    let shown = '';
+    while (Date.now() < deadline) {
+        await sleep(started.poll_after_ms || 3_000);
+        const build = await (0, api_1.apiJson)(client, `/api/v1/projects/${projectId}/builds/${started.deploy_id}`);
+        if (build.phase !== shown) {
+            shown = build.phase;
+            (0, ui_1.step)(build.phase_title);
+        }
+        if (build.phase === 'done' || build.phase === 'failed')
+            return build;
+    }
+    throw new errors_1.CliError('Сборка идёт дольше ожидаемого', `Посмотреть состояние: xflow deployments. Версия ${started.deploy_id}`);
 }
 async function deploy(args) {
     const { root, config } = (0, config_1.requireProject)();
     const client = (0, session_1.connect)(config);
-    const buildCommand = config.build?.command ?? 'npm run build';
-    const buildDir = (0, node_path_1.resolve)(root, config.build?.dir ?? 'dist');
     let revision;
     if ((0, args_1.flagBool)(args, 'no-push')) {
         const server = await (0, sources_1.latestRevision)(client, config.projectId);
@@ -50,34 +65,34 @@ async function deploy(args) {
             throw new errors_1.CliError('На сервере нет исходников', 'Отправьте их: xflow push');
         }
         revision = server.revision;
-        (0, ui_1.warn)(`Исходники не отправлены (--no-push), деплой пойдёт от ревизии ${revision}`);
+        (0, ui_1.warn)(`Исходники не отправлены (--no-push), сборка пойдёт от ревизии ${revision}`);
     }
     else {
         revision = (await (0, sources_1.pushSources)(root, config, client, { force: (0, args_1.flagBool)(args, 'force') })).revision;
     }
-    if (!(0, args_1.flagBool)(args, 'skip-build')) {
-        // Перед сборкой, а не после: адреса функций попадают в бандл на этом шаге.
-        await (0, functions_1.refreshFunctionsEnv)(root, client, config.projectId);
-        (0, ui_1.step)(`Сборка: ${buildCommand}`);
-        await runBuild(buildCommand, root);
-    }
-    const files = (0, tree_1.collectArtifact)(buildDir);
-    if (files.length === 0) {
-        throw new errors_1.CliError(`Каталог сборки пуст: ${buildDir}`, 'Проверьте build.dir в xflow.json: там должен быть каталог, куда сборщик кладёт результат');
+    (0, ui_1.step)(`Собираю на платформе из ревизии ${revision}`);
+    let started;
+    try {
+        started = await (0, api_1.apiJson)(client, `/api/v1/projects/${config.projectId}/builds`, {
+            method: 'POST',
+            body: { revision },
+        });
     }
-    // Платформа раздаёт статику. Ловим здесь, а не после заливки: ошибка о том,
-    // что сборка серверная, полезна до того, как проект отдаст пустую страницу.
-    if (!files.some((f) => f.path === 'index.html')) {
-        throw new errors_1.CliError(`В корне ${buildDir} нет index.html`, 'Похоже на серверную сборку (SSR), а платформа раздаёт статику: соберите приложение как SPA');
+    catch (e) {
+        if (e instanceof api_1.ApiError && e.issues?.length)
+            reportIssues(e);
+        throw e;
     }
-    const archive = (0, zip_1.zipCreate)(files);
-    if (archive.length > MAX_ARTIFACT_BYTES) {
-        throw new errors_1.CliError(`Артефакт ${(0, ui_1.formatBytes)(archive.length)}, потолок ${(0, ui_1.formatBytes)(MAX_ARTIFACT_BYTES)}`, 'Уберите из сборки исходные карты (sourcemaps) и неиспользуемые ассеты');
+    const build = await waitForBuild(client, config.projectId, started);
+    if (build.phase === 'failed') {
+        if (build.log_tail) {
+            (0, ui_1.out)();
+            (0, ui_1.out)(build.log_tail);
+        }
+        throw new errors_1.CliError(build.error || 'Сборка не удалась', `Исправьте код и повторите: xflow deploy. Версия ${build.deploy_id}`);
     }
-    (0, ui_1.step)(`Выкладываю ${files.length} файлов (${(0, ui_1.formatBytes)(archive.length)})`);
-    const result = await (0, api_1.apiUpload)(client, `/api/v1/projects/${config.projectId}/deploy`, archive, { 'X-Revision': String(revision) });
-    (0, ui_1.ok)(`Версия ${result.deploy_id} собрана из ревизии ${result.revision}`);
-    (0, ui_1.out)(result.url);
+    (0, ui_1.ok)(`Версия ${build.deploy_id} собрана из ревизии ${build.revision} за ${build.elapsed_s} с`);
+    (0, ui_1.out)(build.project_url);
     (0, ui_1.note)((0, ui_1.dim)('  Показать посетителям: xflow publish'));
 }
 async function publish() {
@@ -89,9 +104,9 @@ async function publish() {
         (0, ui_1.ok)('Эта версия уже опубликована');
     }
     else {
-        (0, ui_1.ok)(`Опубликована версия ${result.deploy_id}`);
+        (0, ui_1.ok)(`Опубликована версия ${result.deploy_id}: её видят посетители`);
     }
-    (0, ui_1.out)(result.url);
+    (0, ui_1.out)(result.project_url);
 }
 async function rollback(args) {
     const { config } = (0, config_1.requireProject)();
@@ -101,8 +116,8 @@ async function rollback(args) {
     }
     const client = (0, session_1.connect)(config);
     const result = await (0, api_1.apiJson)(client, `/api/v1/projects/${config.projectId}/rollback`, { method: 'POST', body: { deploy_id: deployId } });
-    (0, ui_1.ok)(`dev-адрес переключён на версию ${result.deploy_id}`);
-    (0, ui_1.out)(result.url);
+    (0, ui_1.ok)(`dev-версия проекта переключена на ${result.deploy_id}`);
+    (0, ui_1.out)(result.project_url);
     if (result.revision !== null) {
         (0, ui_1.note)((0, ui_1.dim)(`  Код этой версии: xflow pull --revision ${result.revision} --into ./v${result.deploy_id}`));
     }

package/dist/commands/env.js

@@ -0,0 +1,143 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.envList = envList;
+exports.envCheck = envCheck;
+exports.envSet = envSet;
+exports.envRemove = envRemove;
+const node_fs_1 = require("node:fs");
+const node_path_1 = require("node:path");
+const api_1 = require("../api");
+const args_1 = require("../args");
+const config_1 = require("../config");
+const errors_1 = require("../errors");
+const session_1 = require("../session");
+const ui_1 = require("../ui");
+const FUNCTIONS_DIR = 'functions';
+/** Что функции просят у окружения: `process.env.NAME` и `process.env['NAME']`. */
+const ENV_REFERENCE = /process\.env(?:\.([A-Z0-9_]+)|\[['"]([A-Z0-9_]+)['"]\])/g;
+/** Свои переменные платформа кладёт сама, спрашивать их у пользователя незачем. */
+const PROVIDED = new Set([
+    'XFLOW_PROJECT_ID',
+    'XFLOW_PROJECT_TOKEN',
+    'XFLOW_PROJECT_SCHEMA',
+    'XFLOW_FUNCTION_NAME',
+    'XFLOW_API_URL',
+    'DATABASE_URL',
+    'NODE_ENV',
+]);
+function sourceFiles(dir, found = []) {
+    if (!(0, node_fs_1.existsSync)(dir))
+        return found;
+    for (const entry of (0, node_fs_1.readdirSync)(dir)) {
+        const full = (0, node_path_1.join)(dir, entry);
+        if ((0, node_fs_1.statSync)(full).isDirectory())
+            sourceFiles(full, found);
+        else if (/\.(ts|js|mjs)$/.test(entry))
+            found.push(full);
+    }
+    return found;
+}
+/** Какие переменные упоминают функции проекта, и в какой из них. */
+function referencedByFunctions(root) {
+    const references = new Map();
+    for (const file of sourceFiles((0, node_path_1.join)(root, FUNCTIONS_DIR))) {
+        const functionName = file.slice((0, node_path_1.join)(root, FUNCTIONS_DIR).length + 1).split(/[\\/]/)[0];
+        const code = (0, node_fs_1.readFileSync)(file, 'utf-8');
+        for (const match of code.matchAll(ENV_REFERENCE)) {
+            const name = match[1] || match[2];
+            if (!name || PROVIDED.has(name))
+                continue;
+            const users = references.get(name) ?? [];
+            if (!users.includes(functionName))
+                users.push(functionName);
+            references.set(name, users);
+        }
+    }
+    return references;
+}
+async function fetchVariables() {
+    const { root, config } = (0, config_1.requireProject)();
+    const client = (0, session_1.connect)(config);
+    const data = await (0, api_1.apiJson)(client, `/api/v1/projects/${config.projectId}/env`);
+    return { names: new Set(data.variables.map((row) => row.name)), rows: data.variables, root };
+}
+async function envList() {
+    const { rows } = await fetchVariables();
+    if (rows.length === 0) {
+        (0, ui_1.note)('Переменных нет');
+        (0, ui_1.note)((0, ui_1.dim)('  Записать: xflow env set SMTP_PASSWORD=секрет'));
+        return;
+    }
+    (0, ui_1.table)(rows.map((row) => [row.name, row.scope === 'project' ? 'только этот проект' : 'вся организация']));
+    (0, ui_1.note)((0, ui_1.dim)('  Значения платформа не отдаёт: их видно только внутри функции'));
+}
+/**
+ * Сверить, хватает ли функциям переменных.
+ *
+ * Это ответ на самый частый способ потерять полчаса: функция выкатилась, а падает
+ * на пустом process.env, потому что переменную забыли записать наверх.
+ */
+async function envCheck() {
+    const { names, root } = await fetchVariables();
+    const referenced = referencedByFunctions(root);
+    if (referenced.size === 0) {
+        (0, ui_1.note)('Функции проекта не читают переменных окружения');
+        return;
+    }
+    const missing = [];
+    const present = [];
+    for (const [name, users] of [...referenced.entries()].sort()) {
+        const row = [name, users.join(', ')];
+        if (names.has(name))
+            present.push(row);
+        else
+            missing.push(row);
+    }
+    if (present.length > 0) {
+        (0, ui_1.out)((0, ui_1.bold)('На платформе:'));
+        (0, ui_1.table)(present);
+    }
+    if (missing.length === 0) {
+        (0, ui_1.ok)('Всем функциям хватает переменных');
+        return;
+    }
+    (0, ui_1.out)('');
+    (0, ui_1.fail)('Нет на платформе:');
+    (0, ui_1.table)(missing);
+    throw new errors_1.CliError(`Переменных не хватает: ${missing.length}`, 'Записать: xflow env set ИМЯ=значение. Пока их нет, функция получит undefined');
+}
+async function envSet(args) {
+    const { root, config } = (0, config_1.requireProject)();
+    const client = (0, session_1.connect)(config);
+    const pair = args.words[1];
+    if (!pair || !pair.includes('=')) {
+        throw new errors_1.CliError('Нужна пара ИМЯ=значение', 'Например: xflow env set SMTP_PASSWORD=секрет');
+    }
+    const name = pair.slice(0, pair.indexOf('=')).trim();
+    const value = pair.slice(pair.indexOf('=') + 1);
+    const result = await (0, api_1.apiJson)(client, `/api/v1/projects/${config.projectId}/env`, {
+        method: 'POST',
+        body: { name, value, scope: (0, args_1.flagString)(args, 'scope') === 'project' ? 'project' : 'organization' },
+    });
+    (0, ui_1.ok)(`${(0, ui_1.bold)(result.name)} записана (${result.scope === 'project' ? 'только этот проект' : 'вся организация'})`);
+    // Значение попадает в функцию на выкатке, а не в момент записи: пока функцию
+    // не передеплоили, в её окружении лежит прежнее.
+    const users = referencedByFunctions(root).get(name);
+    if (users && users.length > 0) {
+        (0, ui_1.note)((0, ui_1.dim)(`  Чтобы значение доехало, перевыложите: xflow functions deploy ${users.join(' && xflow functions deploy ')}`));
+    }
+}
+async function envRemove(args) {
+    const { config } = (0, config_1.requireProject)();
+    const client = (0, session_1.connect)(config);
+    const name = args.words[1];
+    if (!name)
+        throw new errors_1.CliError('Нужно имя переменной', 'Что записано: xflow env');
+    const result = await (0, api_1.apiJson)(client, `/api/v1/projects/${config.projectId}/env?name=${encodeURIComponent(name)}`, { method: 'DELETE' });
+    if (!result.removed) {
+        (0, ui_1.note)(`Переменной ${name} нет`);
+        return;
+    }
+    (0, ui_1.ok)(`${name} удалена`);
+    (0, ui_1.note)((0, ui_1.dim)('  В уже выложенных функциях значение останется до следующей выкатки'));
+}

package/dist/commands/functions.js

@@ -1,7 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.functionsList = functionsList;
-exports.refreshFunctionsEnv = refreshFunctionsEnv;
 exports.functionsInvoke = functionsInvoke;
 exports.functionsDeploy = functionsDeploy;
 const node_fs_1 = require("node:fs");
@@ -78,7 +77,7 @@ async function functionsList() {
         fn.name,
         fn.status === 'deployed' ? 'выложена' : fn.status === 'failed' ? 'ошибка' : fn.status,
         fn.last_deployed_at ? (0, ui_1.formatAge)(fn.last_deployed_at) : '—',
-        fn.error_message ?? fn.invoke_url ?? '',
+        fn.error_message ?? '',
     ]));
 }
 /**

package/dist/commands/mcp.js

@@ -0,0 +1,99 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.mcpInstall = mcpInstall;
+const node_child_process_1 = require("node:child_process");
+const node_os_1 = require("node:os");
+const node_path_1 = require("node:path");
+const api_1 = require("../api");
+const args_1 = require("../args");
+const config_1 = require("../config");
+const session_1 = require("../session");
+const ui_1 = require("../ui");
+/** Клиенты, у которых есть своя команда для добавления сервера. */
+const CLIENTS = [
+    {
+        binary: 'claude',
+        label: 'Claude Code',
+        args: (url, token) => [
+            'mcp',
+            'add',
+            '--transport',
+            'http',
+            'xflow',
+            url,
+            '--header',
+            `Authorization: Bearer ${token}`,
+        ],
+        // Повторный запуск должен обновлять запись, а не спотыкаться о неё: команду
+        // выполняют и после смены ключа, и после обновления пакета.
+        reset: ['mcp', 'remove', 'xflow', '-s', 'local'],
+    },
+];
+const WINDOWS = process.platform === 'win32';
+/**
+ * Запустить чужую программу.
+ *
+ * На Windows без оболочки не найти `.cmd`-обёртки, которыми ставятся все
+ * консольные пакеты npm. А оболочка не экранирует аргументы, а склеивает их:
+ * заголовок «Authorization: Bearer …» разваливается по пробелу. Поэтому на
+ * Windows собираем строку сами и сами же расставляем кавычки.
+ */
+function quote(value) {
+    return WINDOWS ? `"${value.replace(/"/g, '""')}"` : value;
+}
+function execute(binary, args) {
+    // Вывод чужой команды перехватываем, а не пропускаем на экран: клиенты любят
+    // напечатать добавленные заголовки целиком, вместе с ключом.
+    const options = { encoding: 'utf-8' };
+    return WINDOWS
+        ? (0, node_child_process_1.spawnSync)([binary, ...args.map(quote)].join(' '), { ...options, shell: true })
+        : (0, node_child_process_1.spawnSync)(binary, args, options);
+}
+function hasBinary(binary) {
+    return execute(binary, ['--version']).status === 0;
+}
+async function mcpInstall(args) {
+    // Сервер общий для организации, поэтому команда работает и вне папки проекта.
+    const root = (0, config_1.findProjectRoot)();
+    const client = (0, session_1.connect)(root ? (0, config_1.readConfig)(root) : undefined);
+    const url = `${client.apiUrl.replace(/\/+$/, '')}/api/mcp`;
+    const identity = await (0, api_1.apiJson)(client, '/api/v1/me');
+    (0, ui_1.out)(`${(0, ui_1.bold)('Сервер MCP')} ${url}`);
+    (0, ui_1.note)((0, ui_1.dim)(`  Организация: ${identity.organization.name ?? 'без названия'}`));
+    (0, ui_1.note)((0, ui_1.dim)('  Ключ на всю организацию: проект агент называет сам'));
+    let found = 0;
+    let installed = 0;
+    for (const target of CLIENTS) {
+        if (!hasBinary(target.binary))
+            continue;
+        found++;
+        (0, ui_1.step)(`Прописываю в ${target.label}`);
+        execute(target.binary, [...target.reset]);
+        const result = execute(target.binary, target.args(url, client.token));
+        if (result.status === 0) {
+            installed++;
+            (0, ui_1.ok)(`${target.label}: сервер xflow подключён`);
+        }
+        else {
+            const reason = `${result.stderr ?? ''}${result.stdout ?? ''}`.trim();
+            (0, ui_1.note)(`${target.label}: команда завершилась с ошибкой`);
+            if (reason)
+                (0, ui_1.out)((0, ui_1.dim)(`  ${reason.split(client.token).join('<ключ>').split('\n').slice(0, 5).join('\n  ')}`));
+        }
+    }
+    if (installed === 0) {
+        (0, ui_1.note)(found === 0 ? 'Не нашёл клиентов со своей командой подключения.' : 'Добавьте сервер вручную:');
+        (0, ui_1.out)(`  тип: HTTP (streamable)`);
+        (0, ui_1.out)(`  адрес: ${url}`);
+        (0, ui_1.out)(`  заголовок: Authorization: Bearer <ключ>`);
+    }
+    // Ключ печатаем только по явной просьбе: см. комментарий в шапке файла.
+    if ((0, args_1.flagBool)(args, 'show-token')) {
+        (0, ui_1.out)('');
+        (0, ui_1.out)(`${(0, ui_1.bold)('Ключ')} ${client.token}`);
+        (0, ui_1.note)((0, ui_1.dim)('  Не оставляйте его в переписке с агентом'));
+    }
+    else {
+        (0, ui_1.note)((0, ui_1.dim)(`  Ключ лежит в ${(0, node_path_1.join)((0, node_os_1.homedir)(), '.xflow', 'credentials.json')} и на экран не выводится`));
+    }
+}