Method task

sdk/python/src/lib.rs:1936–1957

Delegate a bounded task with the compact object-shaped API.

(&self, py: Python<'_>, options: &Bound<'_, PyDict>)

    /// Delegate a bounded task with the compact object-shaped API.
    fn task(&self, py: Python<'_>, options: &Bound<'_, PyDict>) -> PyResult<PyToolResult> {
        let json_str = py_dict_to_json(options)?;
        let args: serde_json::Value = serde_json::from_str(&json_str)
            .map_err(|e| PyValueError::new_err(format!("Invalid task options: {e}")))?;
        let args = normalize_task_options(args)?;

        let session = self.inner.clone();
        let result = py
            .allow_threads(move || get_runtime().block_on(session.tool("task", args)))
            .map_err(|e| PyRuntimeError::new_err(format!("Task delegation failed: {e}")))?;

        Ok(PyToolResult {
            name: result.name,
            output: result.output,
            exit_code: result.exit_code,
            metadata_json: result.metadata.as_ref().map(serde_json::Value::to_string),
            error_kind_json: result
                .error_kind
                .as_ref()
                .and_then(|k| serde_json::to_string(k).ok()),
        })
    }

    /// Delegate a bounded task to a child agent through the built-in ``task`` tool.
    #[pyo3(signature = (agent, description, prompt, background=false, max_steps=None))]