Struct TurnInput 

pub struct TurnInput {
    pub user_message: String,
    pub tools_invoked: Vec<String>,
    pub trace_event: Option<Value>,
    pub depth: u32,
    pub frame: HashMap<String, Value>,
    pub emit_targets: Vec<Uuid>,
    pub vitals_gate: Option<String>,
    pub vitals_phase: Option<String>,
    pub vitals_trust: Option<f32>,
}

Input for a single agent turn (host fills; runtime does not call LLMs).

Fields

user_message: String

tools_invoked: Vec<String>

trace_event: Option<Value>

depth: u32

Caller-supplied depth hint for metadata/logging only — enforcement uses internal crate::AinlRuntime depth.

frame: HashMap<String, Value>

Frame variables required by procedural declared_reads during patch dispatch.

emit_targets: Vec<Uuid>

After the episode row is written, EMIT_TO edges are inserted from episode_id to each target (additive; default empty). Hosts/tests use this to wire emit routing in the same turn.

vitals_gate: Option<String>

Cognitive vitals from the LLM completion that produced this turn (if available). Written onto the EpisodicNode during episode persistence. None for providers that do not return logprobs (Anthropic, Ollama, etc.).

vitals_phase: Option<String>

vitals_trust: Option<f32>

Trait Implementations

impl Clone for TurnInput

fn clone(&self) -> TurnInput

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for TurnInput

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

Formats the value using the given formatter.

impl Default for TurnInput

fn default() -> TurnInput

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for TurnInput

where TurnInput: Default,

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for TurnInput

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

where __S: Serializer,

Serialize this value into the given Serde serializer.