ai_orchestrator/docs/architecture/08_execution_model.md

Execution Model

Базовый цикл

1. Пользователь создает Task.
2. Planner materializes ExecutionGraph.
3. Graph engine отмечает ready узлы.
4. Orchestrator выбирает runner для каждого ready node.
5. Перед side-effecting action выполняется policy evaluation.
6. Если нужен confirm, создается ConfirmationRequest и graph останавливается.
7. Если action разрешен, runner выполняет node.
8. Node результат сохраняется как output + event trail + optional artifacts.
9. Reviewer может валидировать промежуточный результат.
10. Finalizer формирует user-facing result и cards.

Node Families

Planner

Создает или пересобирает graph. Не выполняет side effects.

Model Call

Использует ModelRouter. Может инициировать fallback, но только внутри router contract.

Tool Call

Использует ToolGateway для MCP.

Local Worker Call

Использует WorkerGateway для thin executor.

Reviewer

Системный шаг quality gate:

• schema validation
• semantic validation
• retry recommendation
• escalate to strong model

Finalizer

Преобразует execution result в user result:

• message text
• cards
• artifacts metadata
• summary

Execution Rules

• workers не создают новые workers;
• model/router adapters не меняют graph напрямую;
• только orchestrator меняет task/node state;
• side effects всегда проходят через policy decision;
• event log пишется на каждом значимом переходе.

Manual And Resume

manual означает, что orchestrator не стартует следующий шаг автоматически. Task остается в waiting_manual до явного resume action.

Replay

Replay не означает повтор side effects автоматически. Replay должен уметь:

• восстанавливать graph state из persisted state;
• переиздавать progress view;
• запускать retry только для разрешенных retryable nodes.