Function tool_call_execute

crates/python/src/py_api/mod.rs:491–532

(
    py: Python<'py>,
    name: String,
    args: &Bound<'py, PyAny>,
    func: Py<PyAny>,
    handle: Option<PyScopeHandle>,
    attributes: Option<PyToolAttributes>,
    data: Option<&Bound<'py, Py

) -> "object", text_signature = "(name: str, args: object, func: object, *, handle: ScopeHandle | None = None, attributes: ToolAttributes | None = None, data: object | None = None, metadata: object | None = None) -> object")]
#[allow(clippy::too_many_arguments)]
fn tool_call_execute<'py>(
    py: Python<'py>,
    name: String,
    args: &Bound<'py, PyAny>,
    func: Py<PyAny>,
    handle: Option<PyScopeHandle>,
    attributes: Option<PyToolAttributes>,
    data: Option<&Bound<'py, PyAny>>,
    metadata: Option<&Bound<'py, PyAny>>,
) -> PyResult<Bound<'py, PyAny>> {
    let args_json = py_to_json(args)?;
    let attrs = attributes
        .map(|a| a.inner)
        .unwrap_or(ToolAttributes::empty());
    let data_json = opt_py_to_json(data)?;
    let metadata_json = opt_py_to_json(metadata)?;
    let exec_fn = py_callable::wrap_py_tool_exec_fn(func);
    let default_fn: ToolExecutionNextFn = Arc::new(move |args| exec_fn(args));
    let parent_handle = handle.map(|h| h.inner).unwrap_or_else(task_scope_top);

    let scope_stack = current_scope_stack_handle();
    pyo3_async_runtimes::tokio::future_into_py(py, async move {
        TASK_SCOPE_STACK
            .scope(scope_stack, async move {
                let result = core_tool_api::tool_call_execute(
                    core_tool_api::ToolCallExecuteParams::builder()
                        .name(name)
                        .args(args_json)
                        .func(default_fn)
                        .parent(parent_handle)
                        .attributes(attrs)
                        .data_opt(data_json)
                        .metadata_opt(metadata_json)
                        .build(),
                )
                .await
                .map_err(to_py_err)?;
                Python::attach(|py| json_to_py(py, &result))
            })
            .await
    })
}

// ---------------------------------------------------------------------------
// LLM lifecycle