@naparnik/mcp 0.10.48 → 0.10.52

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, 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 { 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-CXFF4BPP.js';
 import { fileURLToPath } from 'url';
 import { realpathSync, readFileSync } from 'fs';
 

package/dist/index.d.ts

@@ -576,18 +576,6 @@ declare class Wakefulness {
     private light;
 }
 
-/**
- * Где внутри распакованной портативной сборки лежит сам интерпретатор.
- *
- * ⚠ ТРИ ВАРИАНТА, А НЕ ДВА, И РОВНО ТЕ ЖЕ, ЧТО У ДВИЖКА. Источник правды —
- * `engine/shell-contract.json` → `portable_python.inside`: оттуда их берёт и
- * питон (`engine/setup/python_finder.py`). Копия здесь неизбежна — питон мы
- * ищем ДО того, как есть чем запустить питон, — но прошлая копия знала два
- * варианта из трёх: на сборке, где внутри лежит только `bin/python`, движок
- * питон видел, а сервер MCP нет. Правится сначала JSON, потом сюда; расхождение
- * ловит тест границы (`engine.test.ts`) сверкой с этим JSON.
- */
-declare const INSIDE_PYTHON: string[];
 /** Дом по умолчанию — ровно тот же литерал, что в `engine/kit/home.py`. */
 declare const DEFAULT_HOME = "~/.naparnik";
 /**
@@ -792,54 +780,30 @@ declare class Engine {
     /** Python окружения пака — им считается монтаж. Может ещё не существовать. */
     packPython(): string | null;
     /**
-     * Портативный python, который движок доставил сам (шаг «python» установки).
+     * Питон по замку начинки (`engine/deps.lock.json`), если он уже в хранилище.
      *
-     * ⚠ ЗНАТЬ ПРО НЕГО ОБЯЗАНА И ЭТА СТОРОНА. Он лежит в `<дом>/bin/python` и в
-     * PATH не попадает намеренно — PATH человека мы не трогаем. Пропусти его
-     * здесь, и получится: установка принесла питон, окружение на нём собралось,
-     * а сервер MCP по-прежнему зовёт системный «python», которого нет или
-     * который заглушка из Microsoft Store.
+     * ⚠ ТОЛЬКО СВОЙ. До 2026-09-24 здесь был «python3» из PATH на случай, когда
+     * своего нет, а окружение новой версии собиралось перебором «свой → базовый
+     * питон рабочей версии → системный». Claude Desktop подсунул питон Xcode 3.9,
+     * тот не собрал окружение, и обновление у владельца не вставало целый день.
+     * Решение владельца — «как node_modules»: свой питон по замку, чужого нет.
      */
-    ourPython(): string | null;
+    ourPython(place?: EnginePlace | null): string | null;
     /**
-     * Python для команд движка.
+     * Python для команд движка: окружение пака, а пока его нет — свой питон по
+     * замку. Нет ни того, ни другого — путь, которого нет: `pythonTrouble`
+     * ответит словами «позови setup», а не «spawn python3 ENOENT».
      *
-     * Окружения пака может не быть вовсе — именно это и проверяет `check_setup`,
-     * поэтому запускать проверку его питоном нельзя: получилась бы курица и
-     * яйцо. Команды движка написаны на голой стандартной библиотеке и идут
-     * системным python'ом, когда своего ещё нет.
+     * ⚠ «python3» ИЗ PATH — ТОЛЬКО ПРИ `NAPARNIK_SYSTEM_TOOLS=1`: так тесты и
+     * разработка гоняют движок из исходников без хранилища (та же переменная у
+     * движка, `engine/media/ffmpeg.py`). У покупателя её нет.
      */
     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`.
+     * Принести питон замка ЭТОГО кандидата (или взять уже лежащий) — им движок
+     * кандидата доводит до замка всё остальное (`env-install --step env`).
      */
-    workingBasePython(): string | null;
+    bringPython(place: EnginePlace, report?: (text: string) => void): Promise<string>;
     /** Python ровно названного кандидата, а не текущей версии. */
     candidatePython(place: EnginePlace): string | null;
     /**
@@ -860,12 +824,7 @@ declare class Engine {
      * Весь движок (включая проверку и установку) идёт через запуск python'а.
      * Когда его нет, `execFile` бросает ENOENT, и клиентской нейросети
      * доставалось «spawn python3 ENOENT» — текст, из которого человеку не понять
-     * ничего. Шаг «python», написанный ровно для этого случая, при этом
-     * недостижим по устройству: он сам запускается python'ом.
-     *
-     * На Windows есть отдельная беда: в PATH лежит заглушка Microsoft Store —
-     * `python` там есть, он печатает рекламу магазина и выходит с кодом 9009.
-     * Поэтому проверяем не наличие файла, а ответ на вопрос о версии.
+     * ничего. Проверяем не наличие файла, а ответ на вопрос о версии.
      */
     pythonTrouble(): Promise<string | null>;
     /**
@@ -894,10 +853,11 @@ declare class Engine {
         stderr: string;
     }>;
     /** Запуск через явно выбранный Python нужен проверке кандидата до current. */
-    runWith(executable: string, place: EnginePlace, args: string[], { maxBuffer, timeout, key, }?: {
+    runWith(executable: string, place: EnginePlace, args: string[], { maxBuffer, timeout, key, onLine, }?: {
         maxBuffer?: number;
         timeout?: number;
         key?: string;
+        onLine?: (line: string) => void;
     }): Promise<{
         stdout: string;
         stderr: string;
@@ -1452,21 +1412,6 @@ interface StepOutcome {
 interface FirstInstallTestHooks {
     afterPublishRename?(): void;
 }
-/** Где внутри начинки лежит общая таблица источников питона. */
-declare const SOURCES_FILE = "python-sources.json";
-interface PythonSource {
-    url: string;
-    sha256: string;
-    mb: number;
-}
-/**
- * Ключ платформы ровно в том виде, в каком его пишет питон:
- * `platform.system()`-`platform.machine()`. Совпадение обязано быть точным —
- * таблица одна на две стороны.
- */
-declare function platformKey(os?: NodeJS.Platform, arch?: string): string | null;
-/** Прочитать таблицу питона из установленной начинки. */
-declare function pythonSource(engineDir: string, key?: string | null): PythonSource | null;
 /**
  * Доставить начинку, когда движка нет вовсе.
  *
@@ -1478,17 +1423,44 @@ declare function installPayload(engine: Engine, opts: {
     manifestUrl: string;
     key?: string | undefined;
 }, hooks?: FirstInstallTestHooks): Promise<StepOutcome>;
+
+declare const LOCK_FILE = "deps.lock.json";
+interface LockArchive {
+    url: string;
+    sha256: string;
+    bytes: number;
+}
+/** Питон замка для этой машины: откуда качать и куда положить. */
+interface LockedPython {
+    version: string;
+    archive: LockArchive;
+    /** Папка в хранилище: `<дом>/deps/python/<версия>-<сумма>`. */
+    folder: string;
+    /** Интерпретатор внутри папки. */
+    executable: string;
+}
 /**
- * Доставить портативный python, когда системного нет.
+ * Ключ строки замка ровно в том виде, в каком его пишет питон:
+ * `platform.system()-platform.machine()`.
+ */
+declare function platformKey(os?: NodeJS.Platform, arch?: string): string | null;
+/** `<версия>-<8 знаков суммы каждого архива>` — имя папки в хранилище, как у движка. */
+declare function depFolderName(entry: {
+    version: string;
+    archives: Array<{
+        sha256: string;
+    }>;
+}): string;
+/** Прочитать строку питона из замка начинки; нет замка или сборки под машину — null. */
+declare function lockedPython(engineDir: string, home: string, key?: string | null): LockedPython | null;
+/**
+ * Принести питон замка в хранилище, если его там ещё нет; вернуть путь к нему.
  *
- * ⚠ ЭТО НЕ ДУБЛЬ ШАГА «python» ДВИЖКА, А ЕГО ЕДИНСТВЕННЫЙ ДОСТУПНЫЙ ПУТЬ НА
- * ЧИСТОЙ МАШИНЕ. Как только питон появился, шаг движка снова работает и делает
- * ровно то же самое — оттуда и таблица источников, и место установки.
+ * Папка появляется целиком: распаковка — в соседнюю `.partial-<pid>`, потом
+ * переименование. Лежит уже — сеть не трогаем вовсе: «версию питона не подняли
+ * — используем уже скачанную».
  */
-declare function installPython(engine: Engine, opts: {
-    consent: boolean;
-    version?: string;
-}): Promise<StepOutcome>;
+declare function bringPython(python: LockedPython, report?: (text: string) => void): Promise<string>;
 
 /**
  * Иерархия ошибок клиента Напарника.
@@ -1590,9 +1562,9 @@ declare class NaparnikConfigError extends NaparnikError {
  * годится ли она для новой начинки: разойдись она с пакетом, и в логах будет
  * стоять чужое число, а обновление начнёт считать оболочку не той.
  */
-declare const VERSION = "0.10.48";
+declare const VERSION = "0.10.52";
 /** Как мы представляемся серверу Напарника. По нему в логах видно оболочку. */
-declare const USER_AGENT = "naparnik-mcp/0.10.48";
+declare const USER_AGENT = "naparnik-mcp/0.10.52";
 /**
  * Самая старая начинка (движок монтажа), с которой эта оболочка работает.
  * Обновление начинки ниже этой версии не ставится, а выше — требует оболочки
@@ -1629,7 +1601,7 @@ declare const USER_AGENT = "naparnik-mcp/0.10.48";
  * словами «раздача ещё не обновилась». Номер берётся из УЖЕ СОБРАННОГО
  * артефакта этой волны, а не сочиняется по календарю.
  */
-declare const MIN_ENGINE = "2026.09.24-466";
+declare const MIN_ENGINE = "2026.09.24-478";
 
 /**
  * Что вышло из установки или отката — одними словами у начинки и у тела.
@@ -1896,4 +1868,4 @@ declare function install(n: Settings): Outcome;
 /** Убрать наш блок и ничего кроме него. */
 declare function remove(env?: NodeJS.ProcessEnv): Outcome;
 
-export { type ArgsSchema, type CheckedTool, type CommandOutcome, DEFAULT_HOME, type Decision, DeliveryError, Engine, type EngineManifest, type EnginePlace, ForeignBlockError, INSIDE_PYTHON, INSTALL_STEPS, type InstallOutcome, KEEP_COPIES, KEEP_VERSIONS, LONG_STEPS, MANIFEST_TIMEOUT_MS, MANIFEST_URL, MARKER, MIN_ENGINE, type ManifestOutcome, NaparnikApiClient, NaparnikAuthError, NaparnikClientError, NaparnikConfigError, NaparnikError, NaparnikInsufficientBalanceError, type NaparnikMcpConfig, NaparnikScopeError, NaparnikServerError, NaparnikTimeoutError, type Outcome, PAUSE_HOURS, type PackPassport, SERVER_NAME, SOURCES_FILE, START_SEC, type Settings, TOOL_SEC, type Trial, USER_AGENT, type UpdateDeps, VERSION, buildAll, buildBlock, buildResources, compare, configPath, decide, defineTool, deploy, downloadFile, fetchManifest, fileOrRefusal, findBlock, fromNpxCache, inside, install, installPayload, installPython, jsonSchemaOf, keyInTable, lastLine, loadConfig, markChecked, markCurrent, parseEngineManifest, parseFailure, path, platformKey, previousVersion, probe, pythonSource, refusalFor, remove, rollback, tarEntries, tidyOld, timeToCheck, unpackArchive, withArgs };
+export { type ArgsSchema, type CheckedTool, type CommandOutcome, DEFAULT_HOME, type Decision, DeliveryError, Engine, type EngineManifest, type EnginePlace, ForeignBlockError, INSTALL_STEPS, type InstallOutcome, KEEP_COPIES, KEEP_VERSIONS, LOCK_FILE, LONG_STEPS, MANIFEST_TIMEOUT_MS, MANIFEST_URL, MARKER, MIN_ENGINE, type ManifestOutcome, NaparnikApiClient, NaparnikAuthError, NaparnikClientError, NaparnikConfigError, NaparnikError, NaparnikInsufficientBalanceError, type NaparnikMcpConfig, NaparnikScopeError, NaparnikServerError, NaparnikTimeoutError, type Outcome, PAUSE_HOURS, type PackPassport, SERVER_NAME, START_SEC, type Settings, TOOL_SEC, type Trial, USER_AGENT, type UpdateDeps, VERSION, bringPython, buildAll, buildBlock, buildResources, compare, configPath, decide, defineTool, depFolderName, deploy, downloadFile, fetchManifest, fileOrRefusal, findBlock, fromNpxCache, inside, install, installPayload, jsonSchemaOf, keyInTable, lastLine, loadConfig, lockedPython, markChecked, markCurrent, parseEngineManifest, parseFailure, path, platformKey, previousVersion, probe, refusalFor, remove, rollback, tarEntries, tidyOld, timeToCheck, unpackArchive, withArgs };

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

package/package.json

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