@naparnik/mcp 0.10.15 → 0.10.18

package/CHANGELOG.md

@@ -1,5 +1,23 @@
 # Изменения @naparnik/mcp
 
+## 0.10.18 — 2026-09-23. Для вас ничего не поменялось
+
+В пояснениях расширения поправлено, откуда оно берёт шаги установки и место
+портативного Python. Монтаж идёт как раньше.
+
+## 0.10.17 — 2026-09-23. Для вас ничего не поменялось
+
+Внутри движка форма выбора, проверки, каталог умений, командная строка и
+общий код монтажа разложены по своим папкам, и в пояснениях расширения
+поправлены ссылки на них. Монтаж идёт как раньше, только первый после
+обновления — дольше обычного, один раз.
+
+## 0.10.16 — 2026-09-23. Для вас ничего не поменялось
+
+Внутри движка стиль, звук, герой, запись экрана и установка разложены по своим
+папкам, и в пояснениях расширения поправлены ссылки на них. Монтаж идёт как
+раньше, только первый после обновления — дольше обычного, один раз.
+
 ## 0.10.15 — 2026-09-23. Для вас ничего не поменялось
 
 Внутри движка файлы разложены по папкам, и в пояснениях расширения поправлены

package/README.md

@@ -227,7 +227,7 @@ Desktop подставляет незаполненное поле настро
 портативная сборка в `<дом>/bin/python` → системный. Список мест внутри
 портативной сборки существует в двух копиях (иначе питон не найти, не имея
 питона) и сверяется тестом `src/engine.test.ts`, который читает
-`client/engine/env.py`.
+`client/engine/media/ffmpeg.py`.
 
 ## Оболочка и начинка обновляются порознь
 

package/dist/{chunk-ZXASWNOE.js → chunk-O7XB7YJ5.js}

@@ -720,7 +720,7 @@ function parsePositiveInt(raw, fallback) {
 }
 
 // src/version.ts
-var VERSION = "0.10.15";
+var VERSION = "0.10.18";
 var USER_AGENT = `naparnik-mcp/${VERSION}`;
 var MIN_ENGINE = "2026.09.19-355";
 var LAUNCHER_PROTOCOL = 1;
@@ -1155,7 +1155,7 @@ var LONG_STEPS = /* @__PURE__ */ new Set([
   "model",
   // ⚠ Распознавание речи, вырез героя и чистка голоса весят вместе больше
   // двух гигабайт, и с 2026-09-10 НИ ОДИН из них не входит в `all` (решение
-  // владельца, `install.py`, `SEPARATE_JOBS`). Зовут их поимённо и по просьбе,
+  // владельца, `setup/install.py`, `SEPARATE_JOBS`). Зовут их поимённо и по просьбе,
   // а ждать по ним столько же, сколько раньше ждали модель речи.
   "cutout",
   "voice",
@@ -17195,7 +17195,7 @@ function planTool(engine, key) {
         "\u041F\u0430\u043F\u043A\u0430 \u043F\u0430\u043A\u0430 \u0444\u0438\u0440\u043C\u0435\u043D\u043D\u043E\u0433\u043E \u0441\u0442\u0438\u043B\u044F: \u0447\u0435\u0440\u043D\u043E\u0432\u0438\u043A \u0441\u0447\u0438\u0442\u0430\u0435\u0442\u0441\u044F \u0442\u0430\u043A, \u043A\u0430\u043A \u0435\u0433\u043E \u043F\u043E\u0442\u043E\u043C \u0441\u043E\u0431\u0435\u0440\u0443\u0442"
       ).optional(),
       // ⚠ ТАБЛИЦЫ ВКУСА НАЗВАНЫ ПРИМЕРОМ НАРОЧНО. Дверь к ним открыта движком
-      // (`engine/skills.py`, корень `taste`), но модель о них не узнает ниоткуда:
+      // (`engine/catalog/handbook.py`, корень `taste`), но модель о них не узнает ниоткуда:
       // черновик называет их не всегда, а решение владельца 2026-09-18 разрешило
       // ей писать план ролика целиком — и числа для него она обязана брать из
       // наших замеров, а не из головы. Про «по одной-две за вызов» сказано тут
@@ -18762,7 +18762,7 @@ function chooseWidgetHtml() {
      \u0412\u042B\u0421\u041E\u0422\u042B \u0421\u0410\u041C\u041E\u0419 \u0420\u0410\u041C\u041A\u0418, \u2014 \u0430 \u0440\u0430\u043C\u043A\u0430 \u043E\u0431\u044A\u044F\u0432\u043B\u0435\u043D\u0430 \u043C\u0435\u0440\u043D\u044B\u043C \u044F\u0449\u0438\u043A\u043E\u043C (container-type).
      \u041F\u0440\u043E\u0446\u0435\u043D\u0442\u044B \u043E\u0442 \u0448\u0438\u0440\u0438\u043D\u044B \u0442\u0443\u0442 \u043D\u0435 \u0433\u043E\u0434\u044F\u0442\u0441\u044F: \u043A\u0430\u0434\u0440 9:16, \u0438 \u043F\u043E \u0433\u043E\u0440\u0438\u0437\u043E\u043D\u0442\u0430\u043B\u0438 \u0441
      \u0432\u0435\u0440\u0442\u0438\u043A\u0430\u043B\u044C\u044E \u043E\u043D\u0438 \u0440\u0430\u0437\u043D\u044B\u0435.
-     \u26A0 \u0422\u0415\u041D\u042C, \u0410 \u041D\u0415 \u041E\u0411\u0412\u041E\u0414\u041A\u0410: \u0432 \u0440\u043E\u043B\u0438\u043A\u0435 \u043F\u043E\u0434 \u0441\u0442\u0440\u043E\u043A\u043E\u0439 \u043C\u044F\u0433\u043A\u0438\u0439 \u043E\u0440\u0435\u043E\u043B (engine/halo.py),
+     \u26A0 \u0422\u0415\u041D\u042C, \u0410 \u041D\u0415 \u041E\u0411\u0412\u041E\u0414\u041A\u0410: \u0432 \u0440\u043E\u043B\u0438\u043A\u0435 \u043F\u043E\u0434 \u0441\u0442\u0440\u043E\u043A\u043E\u0439 \u043C\u044F\u0433\u043A\u0438\u0439 \u043E\u0440\u0435\u043E\u043B (engine/look/halo.py),
      \u0438 \u043F\u0440\u0435\u0432\u044C\u044E \u043E\u0431\u044F\u0437\u0430\u043D\u043E \u043F\u043E\u043A\u0430\u0437\u044B\u0432\u0430\u0442\u044C \u0442\u043E \u0436\u0435 \u2014 \u043E\u0431\u0432\u043E\u0434\u043A\u0430 \u0447\u0438\u0442\u0430\u0435\u0442\u0441\u044F \u043A\u0430\u043A \u0441\u0430\u043C\u043E\u0434\u0435\u043B\u043A\u0430. */
   .stage__frame { container-type: size; }
   /* \u26A0 \u0425\u041E\u041B\u0421\u0422 \u041B\u041E\u0416\u0418\u0422\u0421\u042F \u041F\u041E\u0412\u0415\u0420\u0425 \u041A\u0410\u0414\u0420\u0410, \u0410 \u041D\u0415 \u0412\u041C\u0415\u0421\u0422\u041E \u041D\u0415\u0413\u041E. \u041F\u043E\u043A\u0430 \u0444\u0438\u043B\u044C\u0442\u0440 \u043D\u0435 \u0432\u044B\u0431\u0440\u0430\u043D \u0438
@@ -18791,7 +18791,7 @@ function chooseWidgetHtml() {
     line-height: 1;
     /* \u26A0 \u0422\u0415\u041D\u042C \u041C\u042F\u0413\u041A\u0410\u042F \u0418 \u041F\u041E\u0427\u0422\u0418 \u041F\u0420\u041E\u0417\u0420\u0410\u0427\u041D\u0410\u042F, \u0410 \u041D\u0415 \u041E\u0411\u0412\u041E\u0414\u041A\u0410 \u041F\u041E\u0414 \u0412\u0418\u0414\u041E\u041C \u0422\u0415\u041D\u0418. \u041F\u043B\u043E\u0442\u043D\u044B\u0435
        \u0441\u043B\u043E\u0438 \u0447\u0438\u0442\u0430\u043B\u0438\u0441\u044C \u043A\u0430\u043A \u043A\u043E\u043D\u0442\u0443\u0440 \u0432\u043E\u043A\u0440\u0443\u0433 \u0431\u0443\u043A\u0432 \u2014 \u0440\u043E\u0432\u043D\u043E \u0442\u043E, \u0447\u0435\u0433\u043E \u0432 \u0440\u043E\u043B\u0438\u043A\u0435 \u043D\u0435\u0442:
-       \u0434\u0432\u0438\u0436\u043E\u043A \u043A\u043B\u0430\u0434\u0451\u0442 \u0447\u0435\u0442\u044B\u0440\u0435 \u0440\u0430\u0437\u043C\u044B\u0442\u044B\u0445 \u0441\u043B\u043E\u044F \u0441 \u043C\u0430\u043B\u043E\u0439 \u0441\u0438\u043B\u043E\u0439 (engine/halo.py).
+       \u0434\u0432\u0438\u0436\u043E\u043A \u043A\u043B\u0430\u0434\u0451\u0442 \u0447\u0435\u0442\u044B\u0440\u0435 \u0440\u0430\u0437\u043C\u044B\u0442\u044B\u0445 \u0441\u043B\u043E\u044F \u0441 \u043C\u0430\u043B\u043E\u0439 \u0441\u0438\u043B\u043E\u0439 (engine/look/halo.py).
        \u041F\u0440\u0430\u0432\u043B\u0435\u043D\u043E \u0434\u0432\u0430\u0436\u0434\u044B \u043F\u043E \u043E\u0442\u0431\u0440\u0430\u043A\u043E\u0432\u043A\u0435 \u0432\u043B\u0430\u0434\u0435\u043B\u044C\u0446\u0430 (2026-09-13 \u0438 2026-09-15:
        \xAB\u0442\u0435\u043D\u0438 \u0441\u043B\u0438\u0448\u043A\u043E\u043C \u0437\u0430\u043C\u0435\u0442\u043D\u044B\u0435, \u043D\u0430\u0434\u043E \u0431\u043E\u043B\u044C\u0448\u0435 \u043F\u0440\u043E\u0437\u0440\u0430\u0447\u043D\u043E\u0441\u0442\u0438\xBB). */
     text-shadow:
@@ -19656,7 +19656,7 @@ function chooseWidgetHtml() {
   }
 
   // \u0421\u043B\u0443\u0436\u0435\u0431\u043D\u044B\u0435 \u0441\u043B\u043E\u0432\u0430 \u0433\u043B\u0430\u0432\u043D\u044B\u043C\u0438 \u043D\u0435 \u0431\u044B\u0432\u0430\u044E\u0442 \u2014 \u0442\u043E \u0436\u0435 \u043F\u0440\u0430\u0432\u0438\u043B\u043E, \u0447\u0442\u043E \u0432 \u0434\u0432\u0438\u0436\u043A\u0435
-  // (lib/layout.py \u0432 \u043F\u0430\u043A\u0435): \xAB\u0427\u0422\u041E\u0411\u042B\xBB \u0432\u043E \u0432\u0435\u0441\u044C \u043A\u0430\u0434\u0440 \u0447\u0438\u0442\u0430\u0435\u0442\u0441\u044F \u043A\u0430\u043A \u043E\u0448\u0438\u0431\u043A\u0430 \u0432\u0451\u0440\u0441\u0442\u043A\u0438.
+  // (lib/captions/layout.py \u0432 \u043F\u0430\u043A\u0435): \xAB\u0427\u0422\u041E\u0411\u042B\xBB \u0432\u043E \u0432\u0435\u0441\u044C \u043A\u0430\u0434\u0440 \u0447\u0438\u0442\u0430\u0435\u0442\u0441\u044F \u043A\u0430\u043A \u043E\u0448\u0438\u0431\u043A\u0430 \u0432\u0451\u0440\u0441\u0442\u043A\u0438.
   var SMALL_WORDS = (' \u0430 \u043D\u043E \u0438 \u0438\u043B\u0438 \u0434\u0430 \u0436\u0435 \u043B\u0438 \u0431\u044B \u043D\u0435 \u043D\u0438 \u0432 \u0432\u043E \u043D\u0430 \u0437\u0430 \u043D\u0430\u0434 \u043F\u043E\u0434 \u043E\u0442 \u0434\u043E \u043F\u043E \u0438\u0437 \u0443 \u043A \u0441 \u0441\u043E \u043E \u043E\u0431 '
     + '\u043F\u0440\u043E \u0434\u043B\u044F \u043F\u0440\u0438 \u0431\u0435\u0437 \u0447\u0435\u0440\u0435\u0437 \u043C\u0435\u0436\u0434\u0443 \u0442\u043E \u0442\u043E\u0442 \u0442\u0430 \u0442\u0435 \u044D\u0442\u043E \u044D\u0442\u0438 \u044D\u0442\u043E\u0442 \u043A\u0430\u043A \u0447\u0442\u043E \u0447\u0435\u043C \u0447\u0442\u043E\u0431\u044B \u0435\u0441\u043B\u0438 \u043A\u043E\u0433\u0434\u0430 \u0433\u0434\u0435 '
     + '\u0442\u0430\u043C \u0442\u0443\u0442 \u0443\u0436\u0435 \u0435\u0449\u0451 \u0435\u0449\u0435 \u0432\u043E\u0442 \u0442\u0430\u043A \u0432\u044B \u0442\u044B \u043C\u044B \u043E\u043D \u043E\u043D\u0430 \u043E\u043D\u0438 \u044F \u043C\u043D\u0435 \u0442\u0435\u0431\u0435 ').split(' ');

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, McpServer, buildAll, buildResources, StdioServerTransport, fromHost, WHERE_TO_GET_KEY, updateEngine, installStep, NaparnikApiClient, timeToCheck2, manifestUrlFor, fetchManifest, markChecked2, decide, shellDir, timeToCheck, bundleUrlFor, fetchShellManifest, markChecked, decideShell, installedShell, NaparnikConfigError } from './chunk-ZXASWNOE.js';
+import { Engine, chooseBody, handOverToBody, VERSION, rollback, rollbackShell, remove, fromNpxCache, install, keyFromBlock, readConfig, ForeignBlockError, currentMachineFingerprint, McpServer, buildAll, buildResources, StdioServerTransport, fromHost, WHERE_TO_GET_KEY, updateEngine, installStep, NaparnikApiClient, timeToCheck2, manifestUrlFor, fetchManifest, markChecked2, decide, shellDir, timeToCheck, bundleUrlFor, fetchShellManifest, markChecked, decideShell, installedShell, NaparnikConfigError } from './chunk-O7XB7YJ5.js';
 import { fileURLToPath } from 'url';
 import { realpathSync, readFileSync } from 'fs';
 

package/dist/index.d.ts

@@ -122,12 +122,13 @@ declare class NaparnikApiClient {
 /**
  * Где внутри распакованной портативной сборки лежит сам интерпретатор.
  *
- * ⚠ ТРИ ВАРИАНТА, А НЕ ДВА, И РОВНО ТЕ ЖЕ, ЧТО У ДВИЖКА
- * (`engine/env.py` → `_INSIDE_PYTHON`). Копия здесь неизбежна — питон мы
+ * ⚠ ТРИ ВАРИАНТА, А НЕ ДВА, И РОВНО ТЕ ЖЕ, ЧТО У ДВИЖКА. Источник правды —
+ * `engine/shell-contract.json` → `portable_python.inside`: оттуда их берёт и
+ * питон (`engine/setup/python_finder.py`). Копия здесь неизбежна — питон мы
  * ищем ДО того, как есть чем запустить питон, — но прошлая копия знала два
  * варианта из трёх: на сборке, где внутри лежит только `bin/python`, движок
- * питон видел, а сервер MCP нет. Обе стороны сверяет тест границы
- * (`engine.test.ts`), и он читает питоновский исходник, а не повторяет список.
+ * питон видел, а сервер MCP нет. Правится сначала JSON, потом сюда; расхождение
+ * ловит тест границы (`engine.test.ts`) сверкой с этим JSON.
  */
 declare const INSIDE_PYTHON: string[];
 /** Дом по умолчанию — ровно тот же литерал, что в `engine/kit/home.py`. */
@@ -146,12 +147,13 @@ declare const LONG_STEPS: Set<string>;
 /**
  * Все шаги установки, которые понимает движок.
  *
- * ⚠ ЭТО ЗЕРКАЛО `install.py` → `STEPS`, и оно уже один раз разошлось: движок печатал
+ * ⚠ ЭТО ЗЕРКАЛО `STEPS` движка, и оно уже один раз разошлось: движок печатал
  * «Шаг установки „вырез“», а здешний список о таком шаге не знал — клиент
  * оказывался в тупике, потому что инструмент не принимал значение, которое
- * движок сам же и назвал. Правится сверху вниз: сначала `install.py` → `STEPS`,
- * потом сюда. Расхождение сторожит `engine.test.ts` — он читает питоновский
- * исходник, а не повторяет список.
+ * движок сам же и назвал. Источник правды — `engine/shell-contract.json` →
+ * `install_steps`: оттуда `STEPS` берёт и `setup/install.py`. Правится сверху
+ * вниз: сначала JSON, потом сюда. Расхождение сторожит `engine.test.ts` сверкой
+ * с этим JSON.
  */
 declare const INSTALL_STEPS: string[];
 /**
@@ -162,12 +164,12 @@ declare const INSTALL_STEPS: string[];
  * прибита строкой "scripts/edit.py".
  */
 /**
- * ⚠ КЛЮЧИ РУССКИЕ, ПОТОМУ ЧТО ЭТО ОТВЕТ ПИТОНА, А НЕ НАШ ОБЪЕКТ. Паспорт
- * печатает движок монтажа (`pack.json` и команда паспорта), и имена полей — его.
- * Переименование здесь ничего не меняет на той стороне: оболочка просто
- * перестала бы находить поля и объявила бы «паспорт не прочитан» на каждом
- * запуске. Обе стороны сверяет тест границы (`engine.test.ts`), и он читает
- * питоновский исходник, а не повторяет список.
+ * ⚠ ИМЕНА ПОЛЕЙ — ОТВЕТ ПИТОНА, А НЕ НАШ ОБЪЕКТ. Паспорт печатает движок
+ * монтажа (`engine/passport.py` → `as_json`, команда `pack-description`), и
+ * имена полей — его. Переименование здесь ничего не меняет на той стороне:
+ * оболочка просто перестала бы находить поля и объявила бы «паспорт не
+ * прочитан» на каждом запуске. Поля, несущие имена, сверяет с настоящими
+ * `pack.json` и рецептом `tool-declaration.test.ts`.
  */
 interface PackPassport {
     'name': string;
@@ -1307,9 +1309,9 @@ declare class NaparnikConfigError extends NaparnikError {
  * годится ли она для новой начинки: разойдись она с пакетом, и в логах будет
  * стоять чужое число, а обновление начнёт считать оболочку не той.
  */
-declare const VERSION = "0.10.15";
+declare const VERSION = "0.10.18";
 /** Как мы представляемся серверу Напарника. По нему в логах видно оболочку. */
-declare const USER_AGENT = "naparnik-mcp/0.10.15";
+declare const USER_AGENT = "naparnik-mcp/0.10.18";
 /**
  * Самая старая начинка (движок монтажа), с которой эта оболочка работает.
  * Обновление начинки ниже этой версии не ставится, а выше — требует оболочки

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-ZXASWNOE.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-O7XB7YJ5.js';

package/package.json

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