Struct StepMeta 

pub struct StepMeta {
    pub name: String,
    pub max_turns: usize,
    pub journal: bool,
    pub input_schema: Option<Schema>,
    pub output_schema: Option<Schema>,
    pub distribution: Distribution,
}

What the compiler and runtime need to know about a step without running it.

Fields

name: String

The step type’s name, for events and error messages.

max_turns: usize

Cap on turns before the runtime gives up.

Not a safety net so much as a budget: an agent that has not finished in this many turns is looping, and the honest response is to stop and say so rather than burn tokens.

journal: bool

May this step’s effects be written to the journal?

Journaling is what makes a run replayable, but it also means prompts land on disk under $SOMA_CACHE_DIR. Turn it off for a step handling anything that must not be persisted.

input_schema: Option<Schema>

What it accepts (None = anything).

output_schema: Option<Schema>

What it produces (None = unknown).

distribution: Distribution

Where it may run.

Implementations

impl StepMeta

pub fn new(name: impl Into<String>) -> Self

Defaults: a 24-turn budget, journaling on, schemas undeclared, runs locally.

pub fn with_max_turns(self, n: usize) -> Self

Set the turn budget — see StepMeta::max_turns for what running out means.

pub fn without_journal(self) -> Self

Keep this step’s effects out of the journal — and give up replay for it in exchange.

pub fn with_input_schema(self, schema: Schema) -> Self

Declare what this step accepts, so an impossible edge into it fails at compile rather than mid-run.

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

Declare what this step produces, for its successors’ input checks.

Trait Implementations

impl Clone for StepMeta

fn clone(&self) -> StepMeta

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for StepMeta

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for StepMeta

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl From<StepMeta> for NodeMeta

fn from(m: StepMeta) -> Self

Converts to this type from the input type.

impl Serialize for StepMeta

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

where __S: Serializer,

Serialize this value into the given Serde serializer.