Erstan Agent Tools Beta

Временная бета-интеграция Erstan для ИИ-агентов для программирования. Этот репозиторий содержит один широкий плагин, который подключает бета-пользователей к изолированной QA-среде Erstan и предоставляет сфокусированные инструкции по созданию, рецензированию и оптимизации Agents и Skills, управлению запусками и работе с авторизованным контентом рабочего пространства.

Бета-среда: данные и OAuth-разрешения в этом плагине отделены от продакшена. Установите производственный плагин erstan, когда ваше рабочее пространство будет перенесено. После этого этот репозиторий будет выведен из эксплуатации.

Плагин не содержит API-ключа Erstan. Каждый пользователь входит в https://api-qa.erstan.com/v1/mcp через OAuth с помощью своего ИИ-хоста. Серверная политика доступа к бете Erstan остается границей доступа; видимость репозитория не предоставляет доступ к продукту.

Что включено

• erstan-agent-builder — создание, изменение, проверка, тестирование и публикация графов Agent.

• erstan-agent-optimizer — получение существующего Agent и формирование минимального коррелированного с версией предложения по оптимизации.

• erstan-agent-review — рецензирование определений Agent и диагностика запусков на основе устойчивых данных.

• erstan-run-operator — запуск опубликованных Agents и безопасная обработка ожиданий, согласований и трассировок.

• erstan-skill-manager — управление полными версионированными пакетами Erstan Skill.

• erstan-skill-optimizer — получение полного пакета Skill рабочего пространства и его оптимизация без потери бизнес-правил, файлов или метаданных действий.

• erstan-work-manager — работа с авторизованными задачами, проектами, документами, папками и файлами.

Концептуальные операции agent:optimize и skill:optimize распространяются как Skills $erstan-agent-optimizer и $erstan-skill-optimizer. Это не npm CLI-команды. По умолчанию они останавливаются на локальном предложении, подкрепленном данными, и результате проверки; обновления, живые предпросмотры Agent и публикация требуют отдельной явной авторизации.

Related MCP server: mcp-testing-tools

Модель разрешений

Erstan является источником истины для того, к чему может получить доступ подключение. Пользователи управляют подключенными приложениями, областью рабочего пространства, разрешенными семействами инструментов, разрешенными списками проектов или команд, а также политикой согласования на стороне Erstan в Settings > Connected apps.

Начальная авторизация по умолчанию использует рекомендуемый профиль Build. Он включает View agents, Build agents, Run agents, Publish agents, а также разрешения только для чтения: View runs, View work, View documents и View files. Он не разрешает запись задач, документов или файлов. Используйте Review для доступа только на чтение. Для записи используйте Custom с применением соответствующего разрешения Manage work, Edit documents или Edit files, либо выберите Full access.

Пользователи управляют подключением и отзывают его в Settings > Connected apps. Сокращение доступа вступает в силу напрямую. Увеличение разрешений или переход на более широкий профиль требует явной повторной авторизации через OAuth, чтобы фоновый агент не мог расширить собственный грант.

Claude, Codex, ChatGPT или другой MCP-хост владеет локальной сессией подключения и своими собственными средствами контроля подтверждения. Хост может сузить доступ или потребовать дополнительное подтверждение, но он не может предоставить разрешения, которые Erstan отклонил. Отзыв подключения в Erstan делает его недействительным для всех сессий хостов, которые его используют.

Такая двухуровневая модель сохраняет понятность разрешений:

1. Erstan определяет максимально допустимые данные и действия.

2. ИИ-хост решает, вызывать ли действие в этих пределах.

Установка в Codex

erstan-beta@erstan-beta означает plugin-name@marketplace-name; это не идентификатор учетной записи и не секрет.

codex plugin marketplace add erstanai/erstan-agent-tools-beta
codex plugin add erstan-beta@erstan-beta

Откройте новую сессию Codex, с помощью /plugins подтвердите установку, подключите MCP-сервер erstan-beta при появлении запроса и завершите вход в браузере. Плагин использует удаленную конфигурацию сервера в plugins/erstan-beta/.mcp.json.

Установка в Claude Code

claude plugin marketplace add erstanai/erstan-agent-tools-beta
claude plugin install erstan-beta@erstan-beta

Выполните /reload-plugins, затем /mcp, чтобы подключить erstan-beta и завершить OAuth. Claude Code инициирует удаленную авторизацию MCP; плагин не просит пользователя вставлять bearer-токнал или API-ключ.

Установка в Claude Cowork / Desktop

Откройте Customize > Plugins > Browse plugins, выберите Add marketplace и введите:

https://github.com/erstanai/erstan-agent-tools-beta

Установите Erstan Beta и завершите вход в браузере при появлении запроса. Плагины доступны в Claude Cowork и Claude Code, а не в стандартном интерфейсе Claude Chat.

Обновление и удаление

Используйте браузер плагинов хоста, чтобы обновить, отключить или удалить Erstan Beta. Удаление локального плагина не отзывает существующий OAuth-грант Erstan. Просматривайте или отзывайте гранты в Settings > Connected apps в Erstan.

Опубликованные версии и контрольные суммы доступны на GitHub Releases.

ChatGPT и другие хосты

Этот временный бета-репозиторий не представлен в универсальном каталоге плагинов ChatGPT и Codex. Он специально не содержит .app.json: сопоставление приложения OpenAI должно использовать реальный зарегистрированный идентификатор plugin_asdk_app... или plugin_asdk_app... или asdk_app_..., присвоенный при публикации. См. раздел Публикация для границ распространения.

Другие MCP-клиенты могут подключаться напрямую к:

https://api-qa.erstan.com/v1/mcp

Развернутый сервер должен предоставлять совместимое со стандартами обнаружение OAuth и авторизацию. В этом дистрибутиве нет резервного варианта со статическим ключом.

Локальная проверка

Требования: Node.js 20 или новее, Python 3 и, опционально, Claude Code для его встроенного валидатора.

npm run verify
python C:/Users/<you>/.codex/skills/.system/plugin-creator/scripts/validate_plugin.py plugins/erstan-beta
python C:/Users/<you>/.codex/skills/.system/skill-creator/scripts/quick_validate.py plugins/erstan-beta/skills/erstan-agent-builder
claude plugin validate .

Запустите валидатор Skills один раз для каждого каталога в plugins/erstan-beta/skills. CI запускает принадлежащий репозиторию программ проверки выпуска; собственные валидаторы Codex, Skill и Claude остаются обязательными шлюзами выпуска, поскольку их доступность и схемы находятся во владении соответствующих хостов.

Синхронизация из продакшена

Бета-версия распространяемая версия получена из проверенного производственного чикаута с явным преобразованием идентичности и конечнойточной точки. Локально выполните:

npm run sync:production -- --source ../erstan-agent-tools

Команда копирует производственные Skills и ресурсы, выравнивает метаданные плагин, а, сохраняет отличную идентичность erstan-beta и перезаписывает размещенную MCP-конечную точку на https://api-qa.erstan.com/v1/mcp. Ручной вручную работы по диффузии Sync production — с “Sync production distribution” GitHub Actions выполняет то же преобразование, проверяет результат и открывает запрос на извлечение для рецензирования. Он не публикует и не объединяет бета-выпуск. Передавайте --version только тогда, когда требуется более поздний номер предварительной версии; версия должна оставаться предварительной версией production-версии.

Разделение набора инструментов

Этот репозиторий — небольшая устанавливаемая дистрибуция для конечных пользователей. Служебные утилиты мейнтейнеров и автономные диагностические фикстуры принадлежат отдельному репозиторию erstan-agent-toolkit и не должны копироваться в релиз плагинаe.

Лицензия

Apache License 2.0. См. LICENSE.