Struct TaskLaunchInput 

pub struct TaskLaunchInput {
    pub blueprint: Blueprint,
    pub operator_id: String,
    pub role: Role,
    pub ttl: Duration,
    pub operator_kind: Option<OperatorKind>,
    pub bridge_id: Option<String>,
    pub hook_id: Option<String>,
    pub operator_backend_id: Option<String>,
    pub operator_kind_overrides: HashMap<String, OperatorKind>,
    pub init_ctx: Value,
}

Input to TaskLaunchService::launch.

Fields

blueprint: Blueprint

The Blueprint to compile, link, and run.

operator_id: String

Caller-supplied id for the Operator that owns this run.

role: Role

The Operator’s role for this run.

ttl: Duration

How long the attached session is allowed to live.

operator_kind: Option<OperatorKind>

“Runtime Global” tier of the OperatorKind cascade. Some(_) is always an explicit request — including Some(OperatorKind::Automate) — that outranks the BP-level tiers (OperatorDef.kind / Blueprint.default_operator_kind); None leaves it unspecified so those tiers / the final default decide. Under MainAi or Composite, MainAIMiddleware’s spawn_hook before/after callbacks become effective. See crate::core::ctx::collapse_operator_kind.

bridge_id: Option<String>

SeniorBridge registry ID. None — no bridge; Some(id) — attach a bridge previously registered via engine.register_senior_bridge.

hook_id: Option<String>

SpawnHook registry ID. Same shape as above, via engine.register_spawn_hook.

operator_backend_id: Option<String>

Operator registry ID — used on the path that hands the whole spawn off to an external Operator. Name previously registered with engine.register_operator; resolved by OperatorDelegateMiddleware, which — for kind = MainAi or Composite — bypasses inner.spawn and calls operator.execute.

operator_kind_overrides: HashMap<String, OperatorKind>

“Runtime Agent-level” tier (highest priority) of the OperatorKind cascade — per-agent override, keyed by AgentDef.name. Empty by default (no override for any agent). See crate::core::ctx::collapse_operator_kind for the full tier list.

init_ctx: Value

The initial ctx (JSON Value) that flow.ir’s eval_async starts from. Every Step.in $.<path> reference reads from here.

Implementations

impl TaskLaunchInput

pub fn automate( blueprint: Blueprint, operator_id: impl Into<String>, role: Role, ttl: Duration, init_ctx: Value, ) -> Self

Helper for existing callers on the default path — no hooks and no per-agent OperatorKind overrides. Leaves the “Runtime Global” tier unspecified (None), so the BP-level tiers / final default (OperatorKind::Automate) decide — this preserves today’s behaviour for every existing caller without silently forcing Automate as an explicit override that would outrank a BP-declared MainAi/Composite kind.

Trait Implementations

impl Clone for TaskLaunchInput

fn clone(&self) -> TaskLaunchInput

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for TaskLaunchInput

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

Formats the value using the given formatter.