Skip to main content

Agent Execution Plane

The agent execution plane is the per-run dispatch. A run has a worktree, a role, an adapter, a model class, captured stdout/stderr, and a receipt.

Adapter request

AdapterRequest(
goal_id,
task_id,
role,
session_id,
worktree,
environment={...},
timeout_seconds=600,
)

Adapter result

AdapterResult(
status="PASS" | "FAIL" | "TIMEOUT" | "BLOCKED" | "REPAIR_REQUIRED",
exit_code=int,
receipt_path=Path,
stdout_path=Path,
stderr_path=Path,
notes={...},
)

The orchestrator reads status and consumes the receipt. Only PASS advances the task toward terminalization.