Struct LeafContext 

pub struct LeafContext<'a, S: WorkflowState = State> { /* private fields */ }

Leaf 节点能力视图 — 纯借用，不拥有任何状态。

设计原则：

• 只能读 State（&S，不可变引用）
• 只能 emit Mutation（借用在 Engine 的 mutations buffer）
• 只能 emit Stream
• 不能 replace_state / clone_state / fork / merge

与 NodeContext 的区别：

• NodeContext 持有 &mut S（可变引用），Composite 节点可用 replace_state()
• LeafContext 持有 &S（只读引用），编译期保证不能修改 State

Implementations

impl<S: WorkflowState> LeafContext<'_, S>

pub fn state(&self) -> &S

获取类型化状态（只读）。

pub fn record(&mut self, mutation: S::Mutation)

记录一个 Mutation（强类型状态变更命令）到缓冲。

这是 Leaf 节点变更状态的唯一入口。

pub fn emit(&self, chunk: StreamChunk)

发射数据面事件（无 stream 则静默丢弃）。

pub fn is_cancelled(&self) -> bool

检查是否已取消。

pub fn cancel_token(&self) -> &CancellationToken

获取取消令牌引用。

pub fn goto(&mut self, target: impl Into<String>)

跳转到指定节点。

pub fn end(&mut self)

结束执行。

pub fn pause(&mut self, barrier_id: BarrierId, timeout: Option<Duration>)

Barrier 挂起。

pub fn set_token_cost(&mut self, cost: f64)

设置 token 成本。

pub fn set_has_side_effects(&mut self)

标记有副作用。