Struct PlanApprovalGate 

pub struct PlanApprovalGate {
    pub exploring_plan_mode: Arc<AtomicBool>,
    pub pending_plan: Arc<RwLock<Option<String>>>,
    /* private fields */
}

Shared state for the agent-driven plan mode approval flow.

A single Arc<PlanApprovalGate> is created in [AgentRuntimeBuilder::build] and shared between:

• EnterPlanModeTool — sets exploring_plan_mode
• ExitPlanModeTool — clears flag, emits event, awaits decision
• [AgentRuntime] — calls approve / reject
• RunCore — reads exploring_plan_mode to gate writes

Fields

exploring_plan_mode: Arc<AtomicBool>

true while the agent is in exploring (read-only plan) mode.

pending_plan: Arc<RwLock<Option<String>>>

The plan text currently pending review (set by ExitPlanModeTool).

Implementations

impl PlanApprovalGate

pub fn new() -> Self

Create a fresh gate (exploring mode off, no pending decision).

pub async fn wait_for_approval(&self) -> PlanApprovalResult

Block until the human reviewer sets a decision.

Reads the response without holding any lock across .await, preventing deadlocks. On return the stored response is cleared so the gate can be reused for the next exit_plan_mode call.

pub fn approve(&self)

Approve the pending plan. Called by TUI / HTTP on user confirmation.

pub fn reject(&self, reason: impl Into<String>)

Reject the pending plan with a reason. Called by TUI / HTTP.

Trait Implementations

impl Default for PlanApprovalGate

fn default() -> Self

Returns the “default value” for a type.