A2UI выпустила первый CLI для генерации типизированных Python-конструкторов интерфейса

Проект A2UI 30 октября 2026 года опубликовал первый выпуск A2UI CLI — v0.1.0. Его основная функция — команда codegen, которая преобразует схемы каталогов компонентов в типизированные Python-конструкторы. Генератор рассчитан на каталоги версий протокола 0.9, 0.9.1 и 1.0.

A2UI задаёт декларативный формат интерфейсов, создаваемых агентами: агент отправляет JSON с описанием компонентов, а клиентский рендерер сопоставляет их с реализацией в приложении. Как объясняет README проекта на момент выпуска, набор доступных компонентов определяется каталогом, который контролирует разработчик клиента. Новый CLI позволяет получать Python-код непосредственно из такой схемы.

Практический сценарий описан в документации инструмента: после изменения генератора или схемы базового каталога разработчик заново создаёт конструкторы для Python SDK. Это даёт команде способ обновлять производный код по исходному описанию компонентов. Насколько инструмент сокращает трудозатраты или число ошибок, в релизе не измеряется.

Для каталогов 1.0 генератор использует модуль a2ui.builder.v1_0. Отдельно в примечаниях к выпуску отмечена обработка ссылок $defs/Child: они разрешаются как одиночные дочерние компоненты типа Child. Эти детали важны при генерации вложенных интерфейсов и выборе соответствующей версии Python API.

Сам CLI написан на Dart, хотя результат генерации в этом выпуске — Python-код. Документация предлагает запускать его из исходников либо активировать глобально из локального каталога проекта. В манифесте пакета указан Dart SDK версии не ниже 3.10.0 и ниже 4.0.0. Пример запуска из корня репозитория:

dart run dart/a2ui_cli/bin/a2ui.dart codegen --catalog path/to/catalog.json --out path/to/output_dir/

Поддержка каталогов 1.0 не означает, что спецификация A2UI 1.0 уже финализирована. В README, зафиксированном тегом этого релиза, она обозначена как release candidate, а текущим производственным выпуском протокола названа версия 0.9.1. Сам проект остаётся на стадии раннего публичного предварительного доступа и распространяется под лицензией Apache 2.0.

Типизированные конструкторы помогают описывать компоненты в Python, однако совместимость каталога с выбранным рендерером по-прежнему нужно проверять в приложении. Генерация кода также не предоставляет полномочий на выполнение действий: выбор доверенных компонентов, обработка событий и проверки доступа остаются ответственностью разработчика.