Struct BrainProcessor 

pub struct BrainProcessor<B: AgentBrain, Rl: ToolRelay> { /* private fields */ }

Holds the graph state and maps a model tool-call to either a workflow-tool relay (emit FunctionCallResult straight back upstream, no transition — mirrors mcp_tool_call_is_relayed_not_treated_as_transition) or a BrainAction (Transition→Reprompt+result, End→upstream End, Stay).

Generic over AgentBrain + ToolRelay; consumes [ModelToolCall] frames, pushes [ToolResult]/[Reprompt] upstream to the realtime service. Holds the MCP-name set for the current node (the mcp_names branch set in call.rs).

Trait Implementations

impl<B: AgentBrain + 'static, Rl: ToolRelay + 'static> FrameProcessor for BrainProcessor<B, Rl>

fn name(&self) -> &str

Stable, human-readable name (observer events, error attribution, tracing).

fn process_frame<'life0, 'life1, 'async_trait>( &'life0 mut self, env: Envelope, link: &'life1 Link, ) -> Pin<Box<dyn Future<Output = Result<()>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Handle one frame. Push results via link. Must not block: long work (a provider round-trip) is driven by an internally-spawned task that feeds results back as frames. The default impl forwards the frame unchanged in its direction — so a pure observer/no-op processor is process_frame = default.

fn start<'life0, 'life1, 'life2, 'async_trait>( &'life0 mut self, _setup: &'life1 ProcessorSetup, _params: &'life2 StartParams, ) -> Pin<Box<dyn Future<Output = Result<()>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait, 'life2: 'async_trait,

Called once when the Frame::Start frame reaches this processor, before any data frame. Open sockets / spawn provider readers here. Default: no-op.

fn stop<'life0, 'async_trait>( &'life0 mut self, _reason: StopReason, ) -> Pin<Box<dyn Future<Output = Result<()>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

Called on End/Stop/Cancel after the terminal frame is forwarded. Flush + close. Default: no-op.

fn can_generate_metrics(&self) -> bool

Whether this processor produces metrics (pipecat can_generate_metrics, :395). Services override to true.