pub async fn tool_call_execute(params: ToolCallExecuteParams) -> Result<Json>Expand description
Execute a tool call through the managed middleware pipeline.
This runs conditional-execution guardrails, request intercepts, sanitize-request guardrails, execution intercepts, the tool callback, and sanitize-response guardrails in the runtime-defined order.
§Parameters
name: Tool name recorded on emitted lifecycle events.args: Raw tool arguments passed into the managed pipeline.func: Tool callback or execution continuation.parent: Optional explicit parent scope for the emitted tool span.attributes: Tool attribute bitflags applied to the managed span.data: Optional application payload stored on the managed tool handle. It may be used on failure end events that have no output payload.metadata: Optional JSON metadata recorded on emitted events.
§Returns
A Result containing the raw tool result returned by the callback or an
execution intercept.
§Errors
Returns FlowError::GuardrailRejected when conditional-execution
guardrails block the call, or any error raised by request intercepts,
execution intercepts, or the callback itself.
§Notes
When execution fails after the start event has been emitted, the runtime still emits a tool-end event without an output payload.