Struct AgentStepSpec 

pub struct AgentStepSpec {
    pub task_id: String,
    pub agent: String,
    pub description: String,
    pub prompt: String,
    pub max_steps: Option<usize>,
    pub parent_session_id: Option<String>,
    pub output_schema: Option<Value>,
}

A single unit of orchestrated agent work — what to run, independent of where it runs.

Serializable on purpose: a host (书安OS) may ship it to another node, and a future workflow checkpoint persists it. The orchestration layer assigns task_id; everything else mirrors a delegated task.

Fields

task_id: String

Stable id for this step. Flows into lifecycle events (and, later, workflow checkpoints) so a step can be correlated and resumed.

agent: String

Registry key of the agent to run (e.g. "explore", "review").

description: String

Short human label for display/tracking.

prompt: String

The instruction handed to the child agent.

max_steps: Option<usize>

Optional per-step tool-round cap.

parent_session_id: Option<String>

Parent session id, for lifecycle-event correlation.

output_schema: Option<Value>

When set, the step must return a value conforming to this JSON Schema. The executor fulfills it (the local default coerces the step’s output with the structured-output machinery); the validated object lands in StepOutcome::structured.

Implementations

impl AgentStepSpec

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

A step that runs agent with prompt, identified by task_id.

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

pub fn with_parent_session_id( self, parent_session_id: impl Into<String>, ) -> Self

pub fn with_output_schema(self, schema: Value) -> Self

Require this step to return a value conforming to schema.

Trait Implementations

impl Clone for AgentStepSpec

fn clone(&self) -> AgentStepSpec

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for AgentStepSpec

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for AgentStepSpec

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for AgentStepSpec

fn eq(&self, other: &AgentStepSpec) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Serialize for AgentStepSpec

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for AgentStepSpec