Struct WorkflowBuilder 

pub struct WorkflowBuilder { /* private fields */ }

Builder for a Workflow. The executor is mandatory (it is the seam to the host’s placement / scheduling); everything else is optional.

Implementations

impl WorkflowBuilder

pub fn new(executor: Arc<dyn AgentExecutor>) -> Self

Start a builder around executor (the default in-box executor is AgentSession::agent_executor).

pub fn with_budget(self, budget: Arc<WorkflowBudget>) -> Self

Attach the shared budget ledger this workflow reports on.

The SAME Arc<WorkflowBudget> must also be installed as the executor’s child budget_guard (the in-box wiring is done by AgentSession::workflow); the workflow only reads it for budget_snapshot and to emit WorkflowEvent::BudgetExhausted.

pub fn with_store(self, store: Arc<dyn SessionStore>) -> Self

Persist progress so each phase becomes a resume boundary. Without a store, phases run as plain (non-resumable) barriers.

pub fn with_step_events(self, step_events: Sender<AgentEvent>) -> Self

Thread the per-step AgentEvent sender into every combinator call so existing subagent/AHP/trace listeners observe child-run lifecycle events.

pub fn with_root_id(self, root_id: impl Into<String>) -> Self

Set the stable root id used to derive per-phase checkpoint keys. Supply a deterministic id (e.g. session-derived) for resume to work across runs; otherwise a random id is used and resume is effectively disabled.

pub fn build(self) -> Workflow

Finalize the Workflow, creating its event channel.