Host API: команды, события и агенты

Минимальный стабильный контракт для пилота: lifecycle, persistence, view, query и command; события ready/dirty/saved/error; маршрут агента.

Партнёру нужен небольшой стабильный контракт, а не доступ к сотням внутренних каналов desktop-приложения.

Минимальный Host API для пилота

Семейство	Примеры	Для чего нужно
Lifecycle	mount, unmount, open, close	Создать и корректно завершить session.
Persistence	save, saveAs, checkpoint	Вернуть подтверждённый результат в storage.
View	focus, setReadOnly, setLocale, setTheme	Встроить поверхность в пользовательский контекст.
Query	getVersion, getCapabilities, getStatus	Согласовать контракт и доступность функций.
Command	edit, format, undo/redo, review intents	Выполнить только разрешённые mutations.

События, которые понимает host

ready — документная модель доступна и поверхность готова к согласованным действиям.
dirty — принята mutation и есть несохранённая revision.
saved — запись завершилась и результат можно регистрировать как версию.
error / refusal — операция не выполнена; host получает код и безопасное описание причины.

Агенты и автоматизация

Агент не должен имитировать пользователя кликами. Он открывает session, запрашивает capability и bounded projection, находит stable target, предлагает ограниченную mutation, применяет её с expectedRevision, проверяет результат, сохраняет и делает reopen. Такой маршрут можно журналировать, ограничивать политиками и повторять.