Struct WorkerAgentSpec 

pub struct WorkerAgentSpec {
    pub name: String,
    pub description: String,
    pub kind: WorkerAgentKind,
    pub hidden: bool,
    pub permissions: Option<PermissionPolicy>,
    pub model: Option<ModelConfig>,
    pub prompt: Option<String>,
    pub max_steps: Option<usize>,
    pub confirmation_inheritance: Option<ConfirmationInheritance>,
}

Reproducible recipe for a disposable worker/subagent.

This is the public “cattle mode” API: callers define a small, serializable worker spec and register/spawn it repeatedly. The spec compiles to an AgentDefinition consumed by the existing delegation/runtime pipeline.

Fields

name: String

Stable worker name used in task delegation (e.g., “frontend-fixer”).

description: String

Human-readable purpose shown to users and model selectors.

kind: WorkerAgentKind

Preset permission/prompt/step profile.

hidden: bool

Hide from UI lists while still allowing explicit delegation.

permissions: Option<PermissionPolicy>

Optional permission policy override.

model: Option<ModelConfig>

Optional model override.

prompt: Option<String>

Optional worker-specific prompt appended to the core agentic prompt.

max_steps: Option<usize>

Maximum execution steps/tool rounds.

confirmation_inheritance: Option<ConfirmationInheritance>

How child runs resolve Ask decisions.

Implementations

impl WorkerAgentSpec

pub fn new( kind: WorkerAgentKind, name: impl Into<String>, description: impl Into<String>, ) -> Self

Create a worker spec from an explicit preset.

pub fn read_only( name: impl Into<String>, description: impl Into<String>, ) -> Self

Read-only exploration worker.

pub fn planner(name: impl Into<String>, description: impl Into<String>) -> Self

Read-only planning worker.

pub fn implementer( name: impl Into<String>, description: impl Into<String>, ) -> Self

Implementation worker with read/write/bash capability and no recursive task spawning.

pub fn verifier(name: impl Into<String>, description: impl Into<String>) -> Self

Verification worker for tests/checks/reproductions without edits.

pub fn reviewer(name: impl Into<String>, description: impl Into<String>) -> Self

Review worker for correctness/regression/security findings.

pub fn custom(name: impl Into<String>, description: impl Into<String>) -> Self

Strict custom worker. Provide permissions explicitly for non-HITL execution.

pub fn hidden(self, hidden: bool) -> Self

Hide or show this worker in UI lists.

pub fn with_permissions(self, permissions: PermissionPolicy) -> Self

Override the preset permission policy.

pub fn with_model(self, model: ModelConfig) -> Self

Override the preset model.

pub fn with_model_ref(self, model_ref: impl AsRef<str>) -> Self

Override the preset model using provider/model or a model id.

pub fn with_provider_model( self, provider: impl Into<String>, model: impl Into<String>, ) -> Self

Override the preset model using provider and model separately.

pub fn with_prompt(self, prompt: impl Into<String>) -> Self

Override the preset prompt.

pub fn with_max_steps(self, max_steps: usize) -> Self

Override the preset step budget.

pub fn with_confirmation(self, inheritance: ConfirmationInheritance) -> Self

Set confirmation inheritance policy for child runs.

pub fn into_agent_definition(self) -> AgentDefinition

Compile this worker recipe into a runtime agent definition.

Trait Implementations

impl Clone for WorkerAgentSpec

fn clone(&self) -> WorkerAgentSpec

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for WorkerAgentSpec

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for WorkerAgentSpec

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl From<WorkerAgentSpec> for AgentDefinition

fn from(spec: WorkerAgentSpec) -> Self

Converts to this type from the input type.

impl Serialize for WorkerAgentSpec

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

where __S: Serializer,

Serialize this value into the given Serde serializer.