@naparnik/mcp 0.10.43 → 0.10.48

package/dist/cli.js

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { Engine, chooseBody, handOverToBody, VERSION, rollback, rollbackShell, remove, fromNpxCache, install, keyFromBlock, readConfig, ForeignBlockError, currentMachineFingerprint, CrashReporter, watchProcessCrashes, McpServer, buildAll, realPace, buildResources, StdioServerTransport, fromHost, WHERE_TO_GET_KEY, Wakefulness, systemBlocker, updateEngine, installStep, NaparnikApiClient, timeToCheck2, manifestUrlFor, fetchManifest, markChecked2, decide, shellDir, timeToCheck, bundleUrlFor, fetchShellManifest, markChecked, decideShell, installedShell, NaparnikConfigError } from './chunk-DQDZKXDU.js';
+import { Engine, chooseBody, handOverToBody, VERSION, rollback, rollbackShell, remove, fromNpxCache, install, keyFromBlock, readConfig, ForeignBlockError, currentMachineFingerprint, CrashReporter, watchProcessCrashes, McpServer, buildAll, realPace, buildResources, StdioServerTransport, reportInstallFaults, fromHost, WHERE_TO_GET_KEY, Wakefulness, systemBlocker, updateEngine, installStep, NaparnikApiClient, timeToCheck2, manifestUrlFor, fetchManifest, markChecked2, decide, shellDir, timeToCheck, bundleUrlFor, fetchShellManifest, markChecked, decideShell, installedShell, NaparnikConfigError } from './chunk-Q7HJ7ROV.js';
 import { fileURLToPath } from 'url';
 import { realpathSync, readFileSync } from 'fs';
 
@@ -42,8 +42,8 @@ var HOW_MONTAGE_WORKS = `
    \u043C\u043E\u043B\u0447\u0430\u043D\u0438\u0435 \u0447\u0438\u0442\u0430\u0435\u0442\u0441\u044F \xAB\u0437\u0430\u0432\u0438\u0441\u043B\u043E\xBB. \u0413\u043E\u0442\u043E\u0432\u043E \u2014 preview.
 6. \u041F\u0440\u0430\u0432\u043A\u0430 \u0436\u0434\u0451\u0442 \u043F\u0435\u0447\u0430\u0442\u044C \u043F\u0440\u043E\u0447\u0438\u0442\u0430\u043D\u043D\u043E\u0439 \u0441\u0442\u0440\u0430\u043D\u0438\u0446\u044B (stamps, document/edits.md):
    \u0431\u0435\u0437 \u043D\u0435\u0451 plan_edit \u043E\u0442\u043A\u0430\u0436\u0435\u0442 \u0438 \u043F\u0440\u0438\u0448\u043B\u0451\u0442 \u0441\u0442\u0440\u0430\u043D\u0438\u0446\u0443.
-7. \u0422\u044F\u0436\u0451\u043B\u043E\u0435 (\u0432\u044B\u0440\u0435\u0437 \u0433\u0435\u0440\u043E\u044F, \u0440\u0430\u0441\u043F\u043E\u0437\u043D\u0430\u0432\u0430\u043D\u0438\u0435 \u0440\u0435\u0447\u0438) \u2014 \u041F\u041E \u041F\u0420\u041E\u0421\u042C\u0411\u0415: \u043D\u0430\u0437\u043E\u0432\u0438 \u0432\u0435\u0441
-   \u0438\u0437 setup, \u043F\u043E\u0441\u043B\u0435 \xAB\u0434\u0430\xBB setup \u0441 consent=true.
+7. \u0422\u044F\u0436\u0451\u043B\u043E\u0435 (\u0432\u044B\u0440\u0435\u0437 \u0433\u0435\u0440\u043E\u044F, \u0440\u0430\u0441\u043F\u043E\u0437\u043D\u0430\u0432\u0430\u043D\u0438\u0435 \u0440\u0435\u0447\u0438) \u2014 \u041F\u041E \u041F\u0420\u041E\u0421\u042C\u0411\u0415, \u0432\u0435\u0441 \u0438\u0437 setup.
+   \xAB\u0414\u0430\xBB, \xAB\u043E\u0431\u043D\u043E\u0432\u0438\xBB \u2014 \u041E\u0414\u0418\u041D setup \u0441 consent=true.
 
 \u0421\u043F\u0440\u0430\u0432\u043E\u0447\u043D\u0438\u043A \u0433\u043E\u0434\u0438\u0442\u0441\u044F \u0438 \u0431\u0435\u0437 \u0440\u043E\u043B\u0438\u043A\u0430: \u043F\u0440\u0435\u0437\u0435\u043D\u0442\u0430\u0446\u0438\u044F.
 \u041D\u0435 \u0432\u044B\u0434\u0443\u043C\u044B\u0432\u0430\u0439; \u0432\u0440\u0435\u043C\u044F \u2014 \u0442\u043E\u043B\u044C\u043A\u043E \u043E\u0442 \u0438\u043D\u0441\u0442\u0440\u0443\u043C\u0435\u043D\u0442\u0430.
@@ -436,11 +436,11 @@ async function start() {
     );
   }
   if (state.ok) {
-    void awake.during(() => prepareEngine(engine, {
+    void awake.during(() => reportInstallFaults(crashes, () => prepareEngine(engine, {
       key: state.config.apiKey,
       baseUrl: state.config.baseUrl,
       tell: log
-    })).catch((trouble) => {
+    }))).catch((trouble) => {
       log(`\u0434\u0432\u0438\u0436\u043E\u043A \u0434\u043E\u043A\u0430\u0447\u0430\u0442\u044C \u043D\u0435 \u0432\u044B\u0448\u043B\u043E: ${trouble instanceof Error ? trouble.message : String(trouble)}`);
     });
   }

package/dist/index.d.ts

@@ -812,6 +812,34 @@ declare class Engine {
     enginePython(): string;
     /** Python подготовки кандидата — намеренно без fallback на venv старого пака. */
     bootstrapPython(): string;
+    /**
+     * Чем собирать окружение новой версии — по порядку, до первого, кто сумеет.
+     *
+     * ⚠ БАЗОВЫЙ ПИТОН РАБОЧЕЙ ВЕРСИИ СТОИТ ВПЕРЕДИ «python3» ИЗ PATH, И ЭТО
+     * ПОЧИНКА, А НЕ ВКУС. Claude Desktop на маке запускает нас без
+     * `/opt/homebrew/bin` в PATH, и «python3» там — `/usr/bin/python3`, питон
+     * Xcode 3.9. Он собирает venv только ссылками («This build of python cannot
+     * create venvs without using symlinks»), а ссылка на интерпретатор вне версии
+     * не проходит сверку `candidateVenvTrouble`. Обновление 2026.09.24-467 у
+     * владельца встало ровно на этом, хотя рабочая версия собрана Homebrew 3.14
+     * копиями и работает. Движок при первой установке ищет питон сам
+     * (`setup/python_finder.py`) и пишет, какой взял, в `pyvenv.cfg` окружения —
+     * этот и берём: он уже однажды собрал здесь рабочее окружение копиями.
+     *
+     * ⚠ НЕ ПИТОН САМОГО VENV. Окружение старой версии удаляется уборкой после
+     * обновления, и кандидат, собранный его питоном, остался бы без интерпретатора
+     * (`engine-candidate.test.ts`). База из `pyvenv.cfg` лежит вне версий.
+     */
+    bootstrapPythons(): string[];
+    /**
+     * Базовый интерпретатор окружения рабочей версии — из её `pyvenv.cfg`.
+     *
+     * `home` раньше `executable`: у Homebrew `executable` указывает в папку
+     * конкретного выпуска (`Cellar/python@3.14/3.14.7/…`), и после `brew upgrade`
+     * её уже нет, а `home` (`/opt/homebrew/opt/python@3.14/bin`) переживает
+     * обновление. Нет файла или записанного питона на диске — `null`.
+     */
+    workingBasePython(): string | null;
     /** Python ровно названного кандидата, а не текущей версии. */
     candidatePython(place: EnginePlace): string | null;
     /**
@@ -874,6 +902,19 @@ declare class Engine {
         stdout: string;
         stderr: string;
     }>;
+    /**
+     * То же, что `command`, но строки stderr уходят в `onLine` по мере печати.
+     *
+     * ⚠ РАДИ СКАЧИВАНИЯ НАЧИНКИ. `deliver` печатает «Скачано 3 МБ из 6 (50%)» в
+     * stderr по ходу, а `command` отдаёт всё разом в конце — и полоса обновления
+     * стояла без единой цифры, пока архив качался (владелец 2026-09-24: «как
+     * будто завис»). Строки те же, что у задач движка, и полоса разбирает их тем
+     * же `DOWNLOAD` (`job-report.ts`).
+     */
+    commandLive(args: string[], { timeout, key }: {
+        timeout?: number;
+        key?: string;
+    }, onLine: (line: string) => void): Promise<CommandOutcome>;
     /** Одна строка вывода команды — например, номер заведённого задания. */
     asString(place: EnginePlace, args: string[], key?: string): Promise<string>;
     /**
@@ -1155,6 +1196,12 @@ interface ScrubContext {
     secrets: string[];
 }
 
+/**
+ * Что стало с отчётом — от этого зависят слова человеку.
+ * `sent` — сервер принял (сейчас или раньше тот же отпечаток); `queued` —
+ * лежит на диске и уйдёт с досылкой; `none` — не уйдёт (сервер отбил).
+ */
+type Delivery = 'sent' | 'queued' | 'none';
 /** Хост — программа, в которой живёт оболочка (`clientInfo` рукопожатия MCP). */
 type Host = {
     name: string;
@@ -1210,8 +1257,17 @@ declare class CrashReporter {
     /** Запомнить строки аргументов вызова — чтобы вычеркнуть их из будущих отчётов. */
     noteSecrets(secrets: string[]): void;
     noteHost(host: Host | null): void;
-    /** Отправить отчёт мимо ответа. Для тестов и смоука — `settled()`. */
-    submit(crash: Crash): void;
+    /**
+     * Отправить отчёт. Ответ инструмента ждёт итог через {@link wordsFor}, а
+     * всё прочее — нет; для тестов и смоука — `settled()`.
+     */
+    submit(crash: Crash): Promise<Delivery>;
+    /**
+     * Итог отправки для слов человеку — не дольше таймаута отправки с запасом.
+     * Не успела — отчёт ещё в пути и либо уйдёт, либо ляжет в очередь: «уйдёт»
+     * правда в обоих случаях.
+     */
+    outcome(delivery: Promise<Delivery>): Promise<Delivery>;
     /**
      * Процесс падает: отчёт кладётся на диск СИНХРОННО и уходит на следующем
      * запуске. Сеть здесь не трогаем — процессу осталось жить миллисекунды, и
@@ -1534,9 +1590,9 @@ declare class NaparnikConfigError extends NaparnikError {
  * годится ли она для новой начинки: разойдись она с пакетом, и в логах будет
  * стоять чужое число, а обновление начнёт считать оболочку не той.
  */
-declare const VERSION = "0.10.43";
+declare const VERSION = "0.10.48";
 /** Как мы представляемся серверу Напарника. По нему в логах видно оболочку. */
-declare const USER_AGENT = "naparnik-mcp/0.10.43";
+declare const USER_AGENT = "naparnik-mcp/0.10.48";
 /**
  * Самая старая начинка (движок монтажа), с которой эта оболочка работает.
  * Обновление начинки ниже этой версии не ставится, а выше — требует оболочки
@@ -1691,10 +1747,28 @@ interface UpdateDeps {
         timeout?: number;
         key?: string;
     }): Promise<CommandOutcome>;
+    /** Команда со строками хода по мере печати; нет — скачивание идёт молча, как раньше. */
+    commandLive?(args: string[], opts: {
+        timeout?: number;
+        key?: string;
+    }, onLine: (line: string) => void): Promise<CommandOutcome>;
     enginePython(): string;
     pythonEnv(): NodeJS.ProcessEnv;
 }
-interface DeployTestHooks {
+/**
+ * Что обновлению сказать по ходу: строки скачивания и «скачал, дальше ставлю».
+ *
+ * ⚠ БЕЗ ЭТОГО ПОЛОСА СТОЯЛА НА «НАЧИНАЮ» ВЕСЬ ВЫЗОВ. Скачивание и сборка
+ * окружения шли внутри одного `setup`, и человек 51 секунду не видел ни слова
+ * (владелец 2026-09-24, Claude Desktop). Теперь обновление — задача
+ * (`setup-job.ts`), и её этапы двигают ровно эти два крючка.
+ */
+interface DeployHooks {
+    /** Строка хода от движка: «Скачано 3 МБ из 6 (50%), осталось около 5 с». */
+    line?(text: string): void;
+    /** Архив скачан и разложен — дальше сборка окружения и проверка. */
+    downloaded?(): void;
+    /** Только для тестов: обрыв ровно между переименованием и записью кандидата. */
     afterPublishRename?(): void;
 }
 /**
@@ -1707,7 +1781,7 @@ interface DeployTestHooks {
  */
 declare function deploy(engine: UpdateDeps, manifest: EngineManifest, trial?: Trial, 
 /** Ключ для закрытой раздачи движка: без него скачивание получит 403. */
-key?: string, hooks?: DeployTestHooks): Promise<InstallOutcome>;
+key?: string, hooks?: DeployHooks): Promise<InstallOutcome>;
 /**
  * Дымовой прогон новой сборки: запускается ли она вообще и та ли это версия.
  * Возвращает текст беды или null, если всё в порядке.

package/dist/index.js

@@ -1 +1 @@
-export { DEFAULT_HOME, DeliveryError, Engine, ForeignBlockError, INSIDE_PYTHON, INSTALL_STEPS, KEEP_COPIES, KEEP_VERSIONS, LONG_STEPS, MANIFEST_TIMEOUT_MS, MANIFEST_URL, MARKER, MIN_ENGINE, NaparnikApiClient, NaparnikAuthError, NaparnikClientError, NaparnikConfigError, NaparnikError, NaparnikInsufficientBalanceError, NaparnikScopeError, NaparnikServerError, NaparnikTimeoutError, PAUSE_HOURS, SERVER_NAME, SOURCES_FILE, START_SEC, TOOL_SEC, USER_AGENT, VERSION, buildAll, buildBlock, buildResources, compare, configPath, decide, defineTool, deploy, downloadFile, fetchManifest, fileOrRefusal, findBlock, fromNpxCache, inside, install, installPayload, installPython, jsonSchemaOf, keyInTable, lastLine, loadConfig, markChecked2 as markChecked, markCurrent, parseEngineManifest, parseFailure, path, platformKey, previousVersion, probe, pythonSource, refusalFor, remove, rollback, tarEntries, tidyOld, timeToCheck2 as timeToCheck, unpackArchive, withArgs } from './chunk-DQDZKXDU.js';
+export { DEFAULT_HOME, DeliveryError, Engine, ForeignBlockError, INSIDE_PYTHON, INSTALL_STEPS, KEEP_COPIES, KEEP_VERSIONS, LONG_STEPS, MANIFEST_TIMEOUT_MS, MANIFEST_URL, MARKER, MIN_ENGINE, NaparnikApiClient, NaparnikAuthError, NaparnikClientError, NaparnikConfigError, NaparnikError, NaparnikInsufficientBalanceError, NaparnikScopeError, NaparnikServerError, NaparnikTimeoutError, PAUSE_HOURS, SERVER_NAME, SOURCES_FILE, START_SEC, TOOL_SEC, USER_AGENT, VERSION, buildAll, buildBlock, buildResources, compare, configPath, decide, defineTool, deploy, downloadFile, fetchManifest, fileOrRefusal, findBlock, fromNpxCache, inside, install, installPayload, installPython, jsonSchemaOf, keyInTable, lastLine, loadConfig, markChecked2 as markChecked, markCurrent, parseEngineManifest, parseFailure, path, platformKey, previousVersion, probe, pythonSource, refusalFor, remove, rollback, tarEntries, tidyOld, timeToCheck2 as timeToCheck, unpackArchive, withArgs } from './chunk-Q7HJ7ROV.js';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@naparnik/mcp",
-  "version": "0.10.43",
+  "version": "0.10.48",
   "description": "MCP-сервер Напарника: монтаж вертикального видео на машине пользователя — паузы, субтитры, герой на новом фоне, звук. Видео никуда не уезжает.",
   "license": "SEE LICENSE IN LICENSE.md",
   "private": false,