Понятия

Нормативная терминология рантайма Runne. У каждого термина есть определение и — где это указано в источнике — явное «чем он не является».

Модель исполнения

Термин	Определение
Session	Контекст взаимодействия пользователя с рантаймом. Хранит историю сообщений и ссылки на TaskRun. Session — это не единица исполнения и не владеет исполнением.
TaskRun	Независимая единица исполнения AI-агентного воркфлоу — уникальный ID, жизненный цикл и машина состояний, хранящаяся отдельно от Session.
Attempt	Одна попытка исполнения TaskRun. У каждого Attempt есть уникальный ID и полный audit trail; у TaskRun может быть несколько Attempt. Retry происходит внутри одного Attempt, а не между Attempt.
Step	Один логический шаг внутри Attempt — вызов модели, вызов инструмента, проверка и т.д.
Turn	Одно взаимодействие агент↔модель внутри Step (prompt + ответ).
Agent	Логическая сущность, исполняющая TaskRun, сконфигурированная моделью, системным промптом, инструментами, навыками и политиками.
Primary Agent / Subagent	Primary agent напрямую привязан к TaskRun; subagent создаётся им для подзадачи и получает делегированный TaskRun.
Agent Loop	Главный цикл исполнения — вызов модели → вызов инструмента → наблюдение → … → acceptance gate.

Durable-состояние и восстановление

Термин	Определение
Durable Event	Событие, записанное в постоянное хранилище до выполнения связанного действия — не строка in-memory журнала.
Event Log	Append-only источник истины для состояния TaskRun.
Checkpoint	Сохранённое состояние TaskRun, достаточное для продолжения исполнения (resume).
Resume	Продолжение TaskRun с последнего checkpoint после контролируемой остановки или сбоя.
Retry	Повторное выполнение операции (вызов модели, вызов инструмента) внутри Attempt после ошибки — отличается от resume.
Recovery	Восстановление TaskRun после сбоя рантайма — загрузка последнего checkpoint, переигрывание durable-событий, сверка неоднозначных побочных эффектов.
Audit Trail	Полная хронология значимых событий, достаточная для восстановления исполнения TaskRun.

Доказательства проверки

Термин	Определение
Verification	Стадия жизненного цикла, на которой рантайм проверяет критерии приёмки.
Acceptance Criterion	Одно проверяемое условие успеха.
Acceptance Gate	Набор критериев приёмки, которые должны пройти, чтобы TaskRun достиг completed.

Гранты возможностей и одобрения

Термин	Определение
Capability	Именованная способность, выданная агенту (fs:read, fs:write, process:exec, network:outbound, …).
Capability Grant	Акт выдачи конкретной возможности с определённым скоупом — не глобальное разрешение.
Permission Rule	Правило, определяющее, когда гранта достаточно, а когда требуется одобрение.
Approval	Явное разрешение пользователя на операцию, со скоупом, получателем и TTL. Одобрение — это не грант.
Sandbox	Изолированное окружение, ограничивающее возможности агента по файловой системе, процессам и сети.
Secret	Конфиденциальные данные (API-ключ, токен, пароль), извлекаемые из внешнего хранилища, которые сам рантайм никогда не хранит.

Бюджеты

Термин	Определение
Budget	Лимит на потребление ресурсов TaskRun — время, стоимость, токены, вызовы инструментов, retry, subagents, процессы, сеть, хранилище. Бюджеты применимы (enforceable), а не рекомендательны.
Budget Ledger	Отслеживание потребления каждого активного бюджета.

Control и execution

Термин	Определение
Control Plane	Часть рантайма, управляющая TaskRun — создание, конфигурация, мониторинг.
Execution Plane	Часть, которая фактически исполняет TaskRun — agent loop, вызовы инструментов, вызовы моделей.

Эти определения нормативны в репозитории рантайма (docs/00-foundation/TERMINOLOGY.md). Полный глоссарий и статус источника по каждому термину — в репозитории.