Struct TaskConfig 

pub struct TaskConfig {

    pub prompt: String,
    pub agent: AgentKind,
    pub cwd: Option<PathBuf>,
    pub model: Option<String>,
    pub permission_mode: PermissionMode,
    pub output_format: OutputFormat,
    pub max_turns: Option<u32>,
    pub max_budget_usd: Option<f64>,
    pub timeout_secs: Option<u64>,
    pub system_prompt: Option<String>,
    pub append_system_prompt: Option<String>,
    pub binary_path: Option<PathBuf>,
    pub env: HashMap<String, String>,
    pub extra_args: Vec<String>,
}

Unified task configuration — everything needed to run a task on any agent.

Fields

prompt: String

The prompt / instruction to send to the agent.

agent: AgentKind

Which agent backend to use.

cwd: Option<PathBuf>

Working directory for the agent.

model: Option<String>

Model override (e.g. “sonnet”, “gpt-5-codex”, “claude-opus-4-6”).

permission_mode: PermissionMode

How to handle tool approvals.

output_format: OutputFormat

Output format.

max_turns: Option<u32>

Maximum number of agentic turns before stopping.

max_budget_usd: Option<f64>

Maximum spend in USD before stopping.

timeout_secs: Option<u64>

Timeout in seconds for the entire run.

system_prompt: Option<String>

Custom system prompt (replaces default).

append_system_prompt: Option<String>

Custom system prompt to append to the default.

binary_path: Option<PathBuf>

Override the agent binary path.

env: HashMap<String, String>

Additional environment variables to set for the agent process.

extra_args: Vec<String>

Extra agent-specific flags passed through verbatim.

Implementations

impl TaskConfig

pub fn new(prompt: impl Into<String>, agent: AgentKind) -> Self

pub fn builder(prompt: impl Into<String>, agent: AgentKind) -> TaskConfigBuilder

Create a builder for TaskConfig.

Trait Implementations

impl Clone for TaskConfig

fn clone(&self) -> TaskConfig

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for TaskConfig

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for TaskConfig

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for TaskConfig

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.