mlspace-plugin 0.2.1__tar.gz → 0.3.0__tar.gz

mlspace_plugin-0.3.0/.agents/plugins/marketplace.json

@@ -0,0 +1,20 @@
+{
+  "name": "mlspace",
+  "interface": {
+    "displayName": "MLSpace"
+  },
+  "plugins": [
+    {
+      "name": "mlspace",
+      "source": {
+        "source": "local",
+        "path": "./plugin"
+      },
+      "policy": {
+        "installation": "AVAILABLE",
+        "authentication": "ON_INSTALL"
+      },
+      "category": "Productivity"
+    }
+  ]
+}

mlspace_plugin-0.3.0/.claude-plugin/marketplace.json

@@ -0,0 +1,12 @@
+{
+  "name": "mlspace",
+  "owner": {
+    "name": "Cloud.ru"
+  },
+  "plugins": [
+    {
+      "name": "mlspace",
+      "source": "./plugin"
+    }
+  ]
+}

mlspace_plugin-0.3.0/.gitignore

@@ -0,0 +1,16 @@
+__pycache__/
+*.py[cod]
+*.egg-info/
+.venv/
+build/
+dist/
+.pytest_cache/
+.mypy_cache/
+.ruff_cache/
+.coverage
+htmlcov/
+.env
+.env.*
+!.env.example
+*.secret
+.DS_Store

{mlspace_plugin-0.2.1 → mlspace_plugin-0.3.0}/INSTALL.md

@@ -1,6 +1,7 @@
 # Установка MLSpace MCP: macOS и Linux
 
-Нужны Python 3.10+, `uv`, установленный Claude Code, Codex или OpenCode,
+Нужны Python 3.10+, `uv` (команда `uvx`), Git для нативных плагинов,
+актуальный Claude Code, Codex или OpenCode,
 Cloud.ru Key ID и Key Secret. Windows пока не поддерживаем.
 
 Первая установка из PyPI выполняется одной командой:
@@ -20,8 +21,11 @@ mlspace-plugin setup
 ```
 
 Если пакет уже установлен: `uv tool install --force .`.
-При установке из wheel: `uv tool install /путь/к/mlspace_plugin-0.2.1-py3-none-any.whl`.
+При установке из wheel: `uv tool install /путь/к/mlspace_plugin-0.3.0-py3-none-any.whl`.
 Не используйте editable-установку из `/tmp` для постоянной работы.
+Далее команды показаны для PyPI. После установки исходников или wheel через
+`uv tool install` заменяйте `uvx mlspace-plugin@latest` на `mlspace-plugin`,
+чтобы использовать именно установленную сборку.
 
 Мастер:
 
@@ -31,7 +35,15 @@ mlspace-plugin setup
    звёздочки показывают ввод. Ключи создаются в консоли Cloud.ru в профиле, «Ключи доступа».
 3. Загрузит воркспейсы. Печатайте имя, проект или ID для поиска. Стрелки перемещают
    курсор, пробел отмечает, Enter завершает выбор. Ctrl-U очищает поиск; выбор сохраняется.
-4. Проверит выбранные воркспейсы, сохранит настройки и подключит MCP вместе со скиллами.
+4. Проверит выбранные воркспейсы и сохранит настройки.
+5. Для Claude Code и Codex добавит marketplace этого GitHub-репозитория и установит
+   `mlspace@mlspace`. Для OpenCode запишет MCP-подключение и скиллы в
+   `~/.config/opencode/skills` (учитывается `XDG_CONFIG_HOME`).
+6. Сверит скиллы, запустит MCP и проверит инструменты и выбранные воркспейсы.
+
+Если настройка клиента не завершилась, проверенные ключи остаются сохранёнными.
+Мастер перечислит установленные клиенты; устраните причину и выполните напечатанную
+команду `Retry`. Она сохраняет выбор клиентов, включая незавершённые подключения.
 
 Откройте новую сессию выбранного клиента; если MCP не появился, перезапустите клиент.
 Сервер запускается клиентом автоматически. Первый запрос:
@@ -41,7 +53,7 @@ mlspace-plugin setup
 ## Stage и корпоративные сертификаты
 
 ```bash
-mlspace-plugin setup --base-url https://mlspace-stage.example.com
+uvx mlspace-plugin@latest setup --base-url https://mlspace-stage.example.com
 ```
 
 Настройка и работа сервера используют системные доверенные сертификаты: Keychain
@@ -49,7 +61,7 @@ mlspace-plugin setup --base-url https://mlspace-stage.example.com
 попросит путь к PEM, полученному у администратора. Можно указать заранее:
 
 ```bash
-mlspace-plugin setup --ca-file /путь/к/corporate-ca.pem
+uvx mlspace-plugin@latest setup --ca-file /путь/к/corporate-ca.pem
 ```
 
 Мастер сохранит копию CA рядом с настройками. Переменные текущего терминала и
@@ -63,10 +75,10 @@ mlspace-plugin setup --ca-file /путь/к/corporate-ca.pem
 ## Повторная настройка
 
 ```bash
-mlspace-plugin setup --force
-mlspace-plugin setup --force --replace-credentials
-mlspace-plugin setup --client opencode
-mlspace-plugin setup --client-path opencode=/полный/путь/opencode
+uvx mlspace-plugin@latest setup --force
+uvx mlspace-plugin@latest setup --force --replace-credentials
+uvx mlspace-plugin@latest setup --force --client opencode
+uvx mlspace-plugin@latest setup --force --client-path opencode=/полный/путь/opencode
 ```
 
 `--force` повторяет настройку с сохранёнными ключами на прежнем endpoint.
@@ -74,13 +86,18 @@ mlspace-plugin setup --client-path opencode=/полный/путь/opencode
 заново, если источник явно не выбран. `--client` можно повторять.
 Существующие посторонние MCP, комментарии JSONC и изменённые пользователем скиллы
 не перезаписываются молча; конфликт показывает путь для разбора.
-Если уже установлен MLSpace native plugin, используйте его и `--config-only`
-либо сначала удалите старую интеграцию, чтобы не создавать второй MCP.
+Уже установленный `mlspace@mlspace` из этого репозитория переиспользуется.
+Если имя marketplace занято другим источником или есть отдельная прямая регистрация
+MLSpace в Claude/Codex, мастер остановится до ввода ключей. Разберите указанное
+подключение; мастер не удаляет его автоматически.
 
 ## Где ключи
 
 `~/.config/mlspace-plugin/.env` (или каталог из `XDG_CONFIG_HOME`): права файла `0600`,
 каталога MLSpace `0700`. В конфиге клиента — только путь и команда запуска.
+Несекретный указатель `~/.config/mlspace-plugin/credentials-path.json` хранит путь
+к выбранному файлу. Поэтому `--path` и нестандартный `XDG_CONFIG_HOME` не требуют
+wrapper или экспорта переменных перед каждым запуском клиента.
 Это не шифрование: процессы того же пользователя и администратор могут прочитать
 файл. Не отправляйте его в чат и не добавляйте в Git. x-api-key получается автоматически
 и не сохраняется. Доступ к каждому выбранному workspace проверяется, но это не
@@ -88,7 +105,7 @@ mlspace-plugin setup --client-path opencode=/полный/путь/opencode
 
 ## Linux по SSH / установка агентом
 
-Запустите `mlspace-plugin setup` в своей SSH-сессии. Браузер и графическая среда не нужны.
+Запустите `uvx mlspace-plugin@latest setup` в своей SSH-сессии. Браузер и графическая среда не нужны.
 Если установкой занимается агент, он готовит пакет, а ключи вы вводите сами в своём
 терминале. После завершения сообщите агенту «готово», без ключей и содержимого `.env`.
 
@@ -99,12 +116,25 @@ mlspace-plugin setup --client-path opencode=/полный/путь/opencode
 
 ## Обновление пакета и скиллов
 
-Для установки через PyPI повторите `uvx mlspace-plugin@latest setup --force`.
-Мастер сохранит ключи, предложит выбор workspace и обновит скиллы без локальных
-изменений. Изменённые вручную скиллы вызовут конфликт с указанием файла.
-Регистрация MCP, созданная мастером и не изменённая вручную, обновляется
-автоматически. Посторонние и изменённые регистрации требуют разбора конфликта.
-Для постоянной установки: `uv tool upgrade mlspace-plugin`, затем
-`mlspace-plugin setup --force`. Для установки из checkout: `uv tool install --force .`.
-Автоматического обновления в фоне нет. Native plugin из архива обновляйте
-через менеджер плагинов клиента; инструкции находятся в `plugin/README.md`.
+```bash
+uvx mlspace-plugin@latest setup --force
+```
+
+Мастер переиспользует ключи, предложит выбор workspace и обновит все сохранившиеся
+подключения, созданные им ранее. `--client` добавляет новые подключения.
+Удалённые подключения не восстанавливаются автоматически.
+
+Claude Code и Codex обновляют нативный плагин через свой менеджер; MCP и скиллы
+приходят из одного релиза. OpenCode обновляет команду MCP и свои скиллы.
+Изменённые вручную конфиги и скиллы OpenCode вызывают конфликт, а не перезапись.
+Кеш нативного плагина принадлежит менеджеру клиента: свои правки храните отдельно.
+
+Для постоянной установки сначала `uv tool upgrade mlspace-plugin`, затем
+`mlspace-plugin setup --force`. Сборка из исходников должна соответствовать
+версии публичного marketplace; для разработки используйте `--config-only`
+или изолированную тестовую установку.
+
+Собственного фонового обновления нет. Настройки автообновления Claude/Codex
+мастер не меняет. Установка и проверка конкретной версии требуют доступа к GitHub
+и PyPI. Если публикация релиза ещё не завершена, setup сообщает об ошибке;
+повторите его после завершения публикации.

{mlspace_plugin-0.2.1 → mlspace_plugin-0.3.0}/INSTALL_AGENT.md

@@ -9,26 +9,32 @@
    При установке из исходников установите пакет в постоянное окружение: `uv tool install .` из checkout или `uv tool install /path/package.whl`.
    Для уже установленного пакета добавьте `--force` только в рамках запрошенного обновления.
    Не оставляйте постоянный запуск на editable-исходниках в `/tmp`.
+   Далее команды показаны для PyPI. Если установили исходники/wheel через `uv tool install`,
+   заменяйте префикс `uvx mlspace-plugin@latest` на `mlspace-plugin`, чтобы использовать именно эту сборку.
 2. Не просите Key ID/Secret в чате, не читайте `.env`, не печатайте окружение и
    не вставляйте ключи в аргументы shell/CLI. Не запускайте интерактивный ввод
    ключей в терминале, который видите только вы.
-3. Дайте человеку одну команду `mlspace-plugin setup` для его собственного терминала
+3. Дайте человеку одну команду `uvx mlspace-plugin@latest setup` для его собственного терминала
    (по SSH — на целевой машине). Для stage добавьте согласованный `--base-url`.
    Объясните: два ключа под звёздочками → поиск и выбор workspace → подключение.
    Дождитесь сообщения о завершении. Человек не должен присылать секреты или файл.
-4. Мастер сам обнаруживает клиентов, проверяет TLS и API, устанавливает MCP и
-   скиллы. Если клиентов несколько, человек выбирает нужные. Для известного
+4. Мастер сам обнаруживает клиентов, проверяет TLS и API. В Claude Code/Codex
+   он добавляет GitHub marketplace и устанавливает нативный плагин; в OpenCode
+   записывает MCP и скиллы в собственный каталог клиента. Если клиентов несколько, человек выбирает нужные. Для известного
    клиента можно заранее дать `--client claude-code`, `--client codex` или `--client opencode`.
    Сбой TLS исправляется системным CA или PEM от администратора через `--ca-file`.
    Никогда не отключайте TLS и не подставляйте сертификат с недоверенного сервера.
-5. Проверьте `mlspace-plugin --list-tools`. Эта команда проверяет только состав
-   инструментов, а не авторизацию и не загрузку выбранным клиентом.
+5. Успешный setup уже проверяет установленные скиллы, MCP initialize, список
+   инструментов и выбранные workspace. Это проверка процесса MCP, а не открытой
+   сессии агента. `--list-tools` само по себе не подтверждает подключение.
    Попросите открыть новую сессию клиента (при необходимости перезапустить).
    После появления MCP выполните read-only запрос списка выбранных workspace.
    До этого не заявляйте, что клиент уже загрузил MCP и скиллы.
 6. Если возник конфликт с существующим плагином или изменённым скиллом,
    разберите названный несекретный путь. Не удаляйте чужую интеграцию автоматически.
-   При частичном успехе сообщите, какие этапы завершены, затем повторите setup с `--force`.
+   При частичном успехе сообщите, какие этапы завершены, и используйте команду `Retry`
+   из ошибки: она сохраняет выбор незавершённых подключений. Для автоматизации
+   добавьте прежние `--non-interactive` и `--workspace`.
 
 ## Автоматизация с уже подготовленными credentials
 
@@ -36,7 +42,7 @@
 файл, передавайте **путь**, не читайте содержимое. Для поиска нужных workspace:
 
 ```bash
-mlspace-plugin setup --non-interactive --credentials-file /path/credentials.env \
+uvx mlspace-plugin@latest setup --non-interactive --credentials-file /path/credentials.env \
   --base-url https://api.ai.cloud.ru --list-workspaces --search project --limit 20
 ```
 
@@ -45,7 +51,7 @@ mlspace-plugin setup --non-interactive --credentials-file /path/credentials.env
 Установка с точными ID, без интерактивных вопросов:
 
 ```bash
-mlspace-plugin setup --non-interactive --credentials-file /path/credentials.env \
+uvx mlspace-plugin@latest setup --non-interactive --credentials-file /path/credentials.env \
   --client opencode --workspace WORKSPACE_UUID
 ```
 

{mlspace_plugin-0.2.1 → mlspace_plugin-0.3.0}/PKG-INFO

@@ -1,6 +1,6 @@
-Metadata-Version: 2.4
+Metadata-Version: 2.5
 Name: mlspace-plugin
-Version: 0.2.1
+Version: 0.3.0
 Summary: Cloud.ru MLSpace plugin: MCP server, agent skills and setup
 Project-URL: Repository, https://github.com/noesskeetit/mlspace-plugin
 Project-URL: Issues, https://github.com/noesskeetit/mlspace-plugin/issues
@@ -107,25 +107,27 @@ mlspace-plugin setup
 Мастер обнаруживает Claude Code, Codex и OpenCode, просит только Key ID и Key Secret
 с маской `*****`, предлагает поиск воркспейсов по имени/проекту/ID и множественный
 выбор. Проверяет API, сохраняет credentials в пользовательский `.env` с правами
-`0600`, подключает MCP и устанавливает все скиллы из пакета. Откройте новую сессию
-клиента; сервер запускается автоматически.
+`0600`. Для Claude Code и Codex мастер добавляет marketplace этого репозитория
+и устанавливает нативный плагин с MCP и скиллами. OpenCode получает MCP и скиллы
+в собственном каталоге. Мастер проверяет запуск MCP; затем откройте новую сессию
+клиента — сервер запускается автоматически.
 
 TLS использует системные доверенные CA. Для корпоративного PEM есть `--ca-file`:
 мастер сохраняет копию для последующих запусков. Ошибка TLS/сети останавливает
 настройку без перезаписи прежнего файла и без запроса ручного x-api-key.
 
-Повторная настройка — `mlspace-plugin setup --force`: сохранённые ключи на прежнем
+Повторная настройка — `uvx mlspace-plugin@latest setup --force`: сохранённые ключи на прежнем
 endpoint переиспользуются. Для замены ключей добавьте `--replace-credentials`.
 Для stage укажите `--base-url https://mlspace-stage.example.com`.
 Только credentials без подключения клиентов — `--config-only`.
-Если уже используете native plugin, выбирайте этот режим, чтобы не дублировать MCP.
+Уже установленный нативный плагин из этого репозитория переиспользуется.
 
 Подробнее: [установка, SSH, сертификаты и повторная настройка](https://github.com/noesskeetit/mlspace-plugin/blob/main/INSTALL.md).
 Для разработки: `uv sync --extra dev` и `uv run pytest`.
 
 **Порядок поиска кредов** — от общего к частному, побеждает более конкретное:
 
-1. `~/.config/mlspace-plugin/.env` — пользовательский конфиг, сюда пишет `setup`
+1. Файл, сохранённый `setup` (по умолчанию `~/.config/mlspace-plugin/.env`)
 2. файл из `MLSPACE_ENV_FILE` — выбран явно
 3. настоящие переменные окружения — бьют любой файл
 
@@ -133,8 +135,10 @@ endpoint переиспользуются. Для замены ключей до
 укажите его явно через `MLSPACE_ENV_FILE`, чтобы чужой репозиторий не мог
 подменить адрес API при использовании сохранённых ключей.
 
-Отсутствующие файлы просто пропускаются, а значения из нижних уровней дополняют
-верхние. Если кредов нет вообще, сервер печатает, где искал, и что запустить.
+`~/.config/mlspace-plugin/credentials-path.json` хранит только путь к выбранному
+файлу: настройка через `--path` или `XDG_CONFIG_HOME` работает и после перезапуска
+клиента с другим окружением. Повреждённый указатель или отсутствующий целевой файл
+дают ошибку; другой аккаунт молча не подставляется.
 
 | Переменная | Обяз. | По умолчанию | Назначение |
 |---|:---:|---|---|
@@ -274,13 +278,14 @@ write-запросов подаются параметром `body: dict`; об
 ## Плагин: Codex, Claude Code и совместимые агенты
 
 [Поставка MLSpace](plugin/README.md) объединяет MCP-сервер и 12 скиллов.
-Внутренний релиз `mlspace-plugin-<версия>.zip` содержит точную версию сервера,
-общие скиллы и манифесты для загрузчиков Codex и Claude Code. Его установка
-не зависит от публикации `mlspace-plugin` в публичном PyPI.
+Обычная установка — `uvx mlspace-plugin@latest setup`: marketplace подключается
+автоматически. Нативные клиенты управляют плагином `mlspace@mlspace` сами.
+Манифест фиксирует точную версию runtime из PyPI вместе со скиллами.
+Ключи и CA остаются в пользовательском конфиге вне кеша плагина.
 
-После распаковки и однократного `mlspace-plugin setup` добавьте каталог релиза как
-marketplace клиента. [Команды установки и сборки](plugin/README.md).
-Ключи остаются в пользовательском конфиге вне плагина.
+Повторный `setup --force` обновляет сохранившиеся подключения мастера.
+Собственного фонового обновления нет; политики автообновления клиентов мастер
+не меняет. ZIP релиза содержит те же манифесты и скиллы, без вложенного wheel.
 
 Для других агентов предусмотрены Agent Plugins 1.0, Agent Skills и обычное
 MCP-подключение; поддержку конкретного загрузчика нужно проверять отдельно.
@@ -318,40 +323,6 @@ MCP-подключение; поддержку конкретного загру
 
 ---
 
-## Защиты от дефектов API
-
-Обёртка гасит несколько особенностей MLSpace API, на которых агент иначе спотыкается.
-API-ловушки ниже проверялись на живом API: основная часть — 03.08.2026,
-региональность `/home/jovyan` — 12.08.2026. Допустимость binary-команд подтверждена
-[официальной CLI-документацией](https://cloud.ru/docs/aicloud/mlspace-cli/topics/references__job-submit)
-и локальной схемой; проверка доступности команды в образе остаётся отдельным шагом.
-
-- **Тип entrypoint и регион проверяются до отправки.** Явный `region` обязателен для
-  каждого типа задачи. Для `type=binary` поле `script` — непустая команда или путь к
-  исполняемому файлу (`ls -lah`, `python /home/jovyan/launch.py -f script.py`); MCP
-  передаёт строку без изменений и не заявляет, что команда существует в выбранном
-  образе. Для остальных типов сохраняется проверка абсолютного пути под
-  `/home/jovyan`. Это NFS конкретного региона: одинаковый путь в notebook `SR006` и
-  job `A100-MT` может указывать на разные данные. Public API не умеет сделать `stat`
-  на целевом NFS, поэтому наличие файла подтверждается same-region notebook'ом или
-  transfer'ом. Локальная проверка формы пути или dry-run не проверяет наличие файла.
-- **Порядок лога восстанавливается.** `logs?tail=N` возвращает строки в обратном
-  порядке — трейсбэк переворачивается, и причина оказывается ниже следствия. MCP
-  сортирует обратно и помечает это в ответе, чтобы модель знала, что порядку можно
-  доверять. Без `tail` порядок правильный и не трогается.
-- **Состояния вместо прозы.** Строки `"No such job"` (логи протухли по retention) и
-  `Job … in queue. Try later` (задача в очереди) приходят внутри `HTTP 200`. MCP
-  распознаёт их и выдаёт понятную типизированную пометку, чтобы «логи устарели» не
-  читалось как «задачи не существует».
-- **Ретрай не уходит в бесконечность.** Часть ручек отдаёт `500` детерминированно
-  (например, assignments на 6 из 7 аллокаций). Совет при `5xx` — повторить один раз,
-  дальше считать отказ постоянным.
-- **Каталог образов сжимается.** `configs` отдаёт ~200 КБ (≈51k токенов), дублируя
-  образы под каждым `instance_type`; MCP дедуплицирует их без потери данных и умеет
-  отфильтровать один регион.
-
----
-
 ## Разработка
 
 ```bash

{mlspace_plugin-0.2.1 → mlspace_plugin-0.3.0}/README.md

@@ -56,25 +56,27 @@ mlspace-plugin setup
 Мастер обнаруживает Claude Code, Codex и OpenCode, просит только Key ID и Key Secret
 с маской `*****`, предлагает поиск воркспейсов по имени/проекту/ID и множественный
 выбор. Проверяет API, сохраняет credentials в пользовательский `.env` с правами
-`0600`, подключает MCP и устанавливает все скиллы из пакета. Откройте новую сессию
-клиента; сервер запускается автоматически.
+`0600`. Для Claude Code и Codex мастер добавляет marketplace этого репозитория
+и устанавливает нативный плагин с MCP и скиллами. OpenCode получает MCP и скиллы
+в собственном каталоге. Мастер проверяет запуск MCP; затем откройте новую сессию
+клиента — сервер запускается автоматически.
 
 TLS использует системные доверенные CA. Для корпоративного PEM есть `--ca-file`:
 мастер сохраняет копию для последующих запусков. Ошибка TLS/сети останавливает
 настройку без перезаписи прежнего файла и без запроса ручного x-api-key.
 
-Повторная настройка — `mlspace-plugin setup --force`: сохранённые ключи на прежнем
+Повторная настройка — `uvx mlspace-plugin@latest setup --force`: сохранённые ключи на прежнем
 endpoint переиспользуются. Для замены ключей добавьте `--replace-credentials`.
 Для stage укажите `--base-url https://mlspace-stage.example.com`.
 Только credentials без подключения клиентов — `--config-only`.
-Если уже используете native plugin, выбирайте этот режим, чтобы не дублировать MCP.
+Уже установленный нативный плагин из этого репозитория переиспользуется.
 
 Подробнее: [установка, SSH, сертификаты и повторная настройка](https://github.com/noesskeetit/mlspace-plugin/blob/main/INSTALL.md).
 Для разработки: `uv sync --extra dev` и `uv run pytest`.
 
 **Порядок поиска кредов** — от общего к частному, побеждает более конкретное:
 
-1. `~/.config/mlspace-plugin/.env` — пользовательский конфиг, сюда пишет `setup`
+1. Файл, сохранённый `setup` (по умолчанию `~/.config/mlspace-plugin/.env`)
 2. файл из `MLSPACE_ENV_FILE` — выбран явно
 3. настоящие переменные окружения — бьют любой файл
 
@@ -82,8 +84,10 @@ endpoint переиспользуются. Для замены ключей до
 укажите его явно через `MLSPACE_ENV_FILE`, чтобы чужой репозиторий не мог
 подменить адрес API при использовании сохранённых ключей.
 
-Отсутствующие файлы просто пропускаются, а значения из нижних уровней дополняют
-верхние. Если кредов нет вообще, сервер печатает, где искал, и что запустить.
+`~/.config/mlspace-plugin/credentials-path.json` хранит только путь к выбранному
+файлу: настройка через `--path` или `XDG_CONFIG_HOME` работает и после перезапуска
+клиента с другим окружением. Повреждённый указатель или отсутствующий целевой файл
+дают ошибку; другой аккаунт молча не подставляется.
 
 | Переменная | Обяз. | По умолчанию | Назначение |
 |---|:---:|---|---|
@@ -223,13 +227,14 @@ write-запросов подаются параметром `body: dict`; об
 ## Плагин: Codex, Claude Code и совместимые агенты
 
 [Поставка MLSpace](plugin/README.md) объединяет MCP-сервер и 12 скиллов.
-Внутренний релиз `mlspace-plugin-<версия>.zip` содержит точную версию сервера,
-общие скиллы и манифесты для загрузчиков Codex и Claude Code. Его установка
-не зависит от публикации `mlspace-plugin` в публичном PyPI.
+Обычная установка — `uvx mlspace-plugin@latest setup`: marketplace подключается
+автоматически. Нативные клиенты управляют плагином `mlspace@mlspace` сами.
+Манифест фиксирует точную версию runtime из PyPI вместе со скиллами.
+Ключи и CA остаются в пользовательском конфиге вне кеша плагина.
 
-После распаковки и однократного `mlspace-plugin setup` добавьте каталог релиза как
-marketplace клиента. [Команды установки и сборки](plugin/README.md).
-Ключи остаются в пользовательском конфиге вне плагина.
+Повторный `setup --force` обновляет сохранившиеся подключения мастера.
+Собственного фонового обновления нет; политики автообновления клиентов мастер
+не меняет. ZIP релиза содержит те же манифесты и скиллы, без вложенного wheel.
 
 Для других агентов предусмотрены Agent Plugins 1.0, Agent Skills и обычное
 MCP-подключение; поддержку конкретного загрузчика нужно проверять отдельно.
@@ -267,40 +272,6 @@ MCP-подключение; поддержку конкретного загру
 
 ---
 
-## Защиты от дефектов API
-
-Обёртка гасит несколько особенностей MLSpace API, на которых агент иначе спотыкается.
-API-ловушки ниже проверялись на живом API: основная часть — 03.08.2026,
-региональность `/home/jovyan` — 12.08.2026. Допустимость binary-команд подтверждена
-[официальной CLI-документацией](https://cloud.ru/docs/aicloud/mlspace-cli/topics/references__job-submit)
-и локальной схемой; проверка доступности команды в образе остаётся отдельным шагом.
-
-- **Тип entrypoint и регион проверяются до отправки.** Явный `region` обязателен для
-  каждого типа задачи. Для `type=binary` поле `script` — непустая команда или путь к
-  исполняемому файлу (`ls -lah`, `python /home/jovyan/launch.py -f script.py`); MCP
-  передаёт строку без изменений и не заявляет, что команда существует в выбранном
-  образе. Для остальных типов сохраняется проверка абсолютного пути под
-  `/home/jovyan`. Это NFS конкретного региона: одинаковый путь в notebook `SR006` и
-  job `A100-MT` может указывать на разные данные. Public API не умеет сделать `stat`
-  на целевом NFS, поэтому наличие файла подтверждается same-region notebook'ом или
-  transfer'ом. Локальная проверка формы пути или dry-run не проверяет наличие файла.
-- **Порядок лога восстанавливается.** `logs?tail=N` возвращает строки в обратном
-  порядке — трейсбэк переворачивается, и причина оказывается ниже следствия. MCP
-  сортирует обратно и помечает это в ответе, чтобы модель знала, что порядку можно
-  доверять. Без `tail` порядок правильный и не трогается.
-- **Состояния вместо прозы.** Строки `"No such job"` (логи протухли по retention) и
-  `Job … in queue. Try later` (задача в очереди) приходят внутри `HTTP 200`. MCP
-  распознаёт их и выдаёт понятную типизированную пометку, чтобы «логи устарели» не
-  читалось как «задачи не существует».
-- **Ретрай не уходит в бесконечность.** Часть ручек отдаёт `500` детерминированно
-  (например, assignments на 6 из 7 аллокаций). Совет при `5xx` — повторить один раз,
-  дальше считать отказ постоянным.
-- **Каталог образов сжимается.** `configs` отдаёт ~200 КБ (≈51k токенов), дублируя
-  образы под каждым `instance_type`; MCP дедуплицирует их без потери данных и умеет
-  отфильтровать один регион.
-
----
-
 ## Разработка
 
 ```bash

{mlspace_plugin-0.2.1 → mlspace_plugin-0.3.0}/RELEASE.md

@@ -7,11 +7,11 @@
    `uv lock` и `uv run python scripts/gen_plugin.py`. Обновите примеры имён wheel/ZIP
    в инструкциях, если версия присутствует в имени файла.
 2. Выполните проверки из `CONTRIBUTING.md` на Linux и macOS.
-3. Соберите пакет (в командах ниже замените 0.2.1 на выпускаемую версию):
+3. Соберите пакет (в командах ниже замените 0.3.0 на выпускаемую версию):
 
 ```sh
-uv build --out-dir dist/release-0.2.1
-uv run python scripts/build_plugin.py --wheel dist/release-0.2.1/mlspace_plugin-0.2.1-py3-none-any.whl --output dist/plugin-release-0.2.1
+uv build --out-dir dist/release-0.3.0
+uv run python scripts/build_plugin.py --output dist/plugin-release-0.3.0
 ```
 
 4. Просмотрите содержимое wheel, sdist и ZIP. В них не должно быть credentials,
@@ -23,18 +23,24 @@ uv run python scripts/build_plugin.py --wheel dist/release-0.2.1/mlspace_plugin-
    `UV_PUBLISH_TOKEN` средствами вашего хранилища секретов, не аргументом команды:
 
 ```sh
-uv publish --trusted-publishing never dist/release-0.2.1/mlspace_plugin-0.2.1-py3-none-any.whl dist/release-0.2.1/mlspace_plugin-0.2.1.tar.gz
+uv publish --trusted-publishing never dist/release-0.3.0/mlspace_plugin-0.3.0-py3-none-any.whl dist/release-0.3.0/mlspace_plugin-0.3.0.tar.gz
 ```
 
 6. Проверьте версию и SHA256 обоих файлов через PyPI JSON API; проверьте установку
-   `uvx --from mlspace-plugin==0.2.1 mlspace-plugin --version` из нового кеша.
-   ZIP и SHA256SUMS приложите к тому же релизу публичного Git-репозитория.
+   `uvx --from mlspace-plugin==0.3.0 mlspace-plugin --version` из нового кеша.
+7. Только после проверки точной версии в PyPI обновите рабочую ветку GitHub
+   marketplace и создайте тег релиза. До этого проверяйте изменения на отдельной
+   release-ветке или локальном Git marketplace: main не должен ссылаться на
+   отсутствующий пакет. ZIP и SHA256SUMS приложите к тому же релизу.
+8. В чистом HOME выполните публичный setup, проверьте source/version нативных
+   плагинов, MCP handshake и загрузку скиллов клиентами. Используйте тестовые
+   credentials и локальный HTTPS-стенд; не выполняйте записи в реальном tenant.
 
 Пакет не проверяет обновления в фоне. Для PyPI пользователь повторяет
 `uvx mlspace-plugin@latest setup --force`: обновляются сервер и неизменённые скиллы.
-Native plugin из ZIP устанавливается отдельно через менеджер плагинов клиента;
-текущий `setup` регистрирует MCP напрямую и копирует скиллы. Не обещайте ему
-автоматическое подключение marketplace или одинаковое автообновление во всех клиентах.
+Claude Code и Codex получают нативный плагин через marketplace этого репозитория;
+OpenCode — MCP и скиллы в собственном каталоге. Политики автообновления клиентов
+не меняются. Не обещайте одинаковое фоновое обновление во всех клиентах.
 
 Перед открытием существующего приватного Git-репозитория проверьте также его
 историю. Проверка wheel и sdist не является проверкой старых Git-коммитов.

{mlspace_plugin-0.2.1 → mlspace_plugin-0.3.0}/plugin/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "mlspace",
-  "version": "0.2.1",
+  "version": "0.3.0",
   "description": "Cloud.ru MLSpace: training jobs, inference, notebooks, data transfer, registry and compute catalog — an MCP server plus skills.",
   "author": {
     "name": "Cloud.ru"

{mlspace_plugin-0.2.1 → mlspace_plugin-0.3.0}/plugin/.codex-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "mlspace",
-  "version": "0.2.1",
+  "version": "0.3.0",
   "description": "Cloud.ru MLSpace: training jobs, inference, notebooks, data transfer, registry and compute catalog — an MCP server plus skills.",
   "author": {
     "name": "Cloud.ru"

{mlspace_plugin-0.2.1 → mlspace_plugin-0.3.0}/plugin/.mcp.json

@@ -5,7 +5,7 @@
       "command": "uvx",
       "args": [
         "--from",
-        "${CLAUDE_PLUGIN_ROOT}/server/mlspace_plugin-0.2.1-py3-none-any.whl",
+        "mlspace-plugin==0.3.0",
         "mlspace-plugin",
         "--transport",
         "stdio"